node-autotask 0.33.0 → 0.37.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 (41) hide show
  1. package/CHANGELOG.md +82 -1
  2. package/MCP_TOOL_CATALOG.json +26 -9
  3. package/MCP_TOOL_MANIFEST.md +14 -13
  4. package/N8N_MCP_MANIFEST.json +5 -5
  5. package/N8N_MCP_MANIFEST.md +4 -4
  6. package/README.md +12 -5
  7. package/capabilities.json +5850 -2557
  8. package/capabilities.schema.json +36 -0
  9. package/dist/capabilities.cjs +2 -2
  10. package/dist/capabilities.d.cts +15 -1
  11. package/dist/capabilities.d.ts +15 -1
  12. package/dist/capabilities.js +1 -1
  13. package/dist/{chunk-7WNE5MPG.js → chunk-2PJCQGXZ.js} +12 -12
  14. package/dist/{chunk-OO67MRHN.cjs → chunk-4GHBN2AW.cjs} +1737 -6620
  15. package/dist/{chunk-5DS6F6GF.js → chunk-75WJS26D.js} +3594 -8477
  16. package/dist/{chunk-3LAZZT7V.cjs → chunk-7WR5WUQT.cjs} +143 -143
  17. package/dist/{chunk-MFDQHFGJ.js → chunk-CH2WXTYD.js} +9445 -3678
  18. package/dist/{chunk-4QN43TRP.cjs → chunk-FYF46OT3.cjs} +9470 -3703
  19. package/dist/{chunk-SP2SJJZX.cjs → chunk-HBYKTXN3.cjs} +5849 -2556
  20. package/dist/{chunk-VKE56TTN.js → chunk-KQ6HMBB4.js} +5849 -2556
  21. package/dist/{index-BaeMHZPk.d.ts → index-DAFg_68I.d.ts} +584 -207
  22. package/dist/{index-Cq0VsfSz.d.cts → index-g8J6Qiu1.d.cts} +584 -207
  23. package/dist/index.cjs +22 -22
  24. package/dist/index.d.cts +2 -2
  25. package/dist/index.d.ts +2 -2
  26. package/dist/index.js +14 -14
  27. package/dist/operations/index.cjs +867 -135
  28. package/dist/operations/index.d.cts +182 -28
  29. package/dist/operations/index.d.ts +182 -28
  30. package/dist/operations/index.js +742 -10
  31. package/dist/pool.cjs +9 -9
  32. package/dist/pool.d.cts +1 -1
  33. package/dist/pool.d.ts +1 -1
  34. package/dist/pool.js +4 -4
  35. package/dist/resources/index.cjs +5 -4
  36. package/dist/resources/index.d.cts +1 -1
  37. package/dist/resources/index.d.ts +1 -1
  38. package/dist/resources/index.js +14 -13
  39. package/docs/API.md +481 -46
  40. package/docs/LIVE-TESTING.md +11 -11
  41. package/package.json +1 -1
@@ -1383,12 +1383,12 @@ declare class HttpClient {
1383
1383
  * BLIND_SURFACE_INVENTORY + REACHABILITY_PROBE_DEFAULTS (issue #11 —
1384
1384
  * the inventory is zero wire; the probe is a bounded read sweep);
1385
1385
  * - operations.createGuidance serves CREATE_GUIDANCE (issue #12 — the
1386
- * 92-entity zone-fact catalog, zero wire);
1386
+ * zone-fact create-guidance catalog, zero wire);
1387
1387
  * - src/resources/base.ts reads UNTRUSTED_FIELDS_BY_RESOURCE for the
1388
1388
  * queryBounded noteChars free-text cap (issue #61 — response-side only);
1389
1389
  * - docs/API.md §11.7/§11.8/§11.9/§11.10/§11.11/§11.12 render the same facts.
1390
1390
  *
1391
- * planHash: 913f1120488735c2e607cda13f9d551b11b3e6534d8a4b8310857d0bbd2fdb45
1391
+ * planHash: 5cd6c6679384651e7f67a0135915bcc031ef542640d9ebb6992b729ca42efe37
1392
1392
  */
1393
1393
 
1394
1394
  /** One pinned blind-surface stamp (the result-time sentinel object). */
@@ -1468,6 +1468,17 @@ interface CreateGuidanceBlocker {
1468
1468
  remedy: string;
1469
1469
  /** The fields the create requires (issue #219 N3) — a DECLARED requirement, never a reconstruction of the (possibly truncated) vendor receipt, which stays in vendorEvidence. Absent = no known requirement beyond the required set. */
1470
1470
  requires?: CreateGuidanceRequires;
1471
+ /** True when the API cannot satisfy this create for any input (a picklist whose values are not exposed, an undocumented required-field ladder) — a structured flag, not prose. Only picklist-unexposed and undocumented-ladder rows carry it. */
1472
+ unsatisfiableViaApi?: boolean;
1473
+ }
1474
+ /** The parent-company hint (issue #246): read the field on the resource record this resource's via field points at. */
1475
+ interface CreateGuidanceParentCompany {
1476
+ /** The field on this resource that points at the parent record (e.g. projectID). */
1477
+ via: string;
1478
+ /** The parent resource key (e.g. projects). */
1479
+ resource: string;
1480
+ /** The company field on the parent (always companyID). */
1481
+ field: string;
1471
1482
  }
1472
1483
  /** A requirement conditioned on a picklist value (issue #219 N3): createGuidance.requiresByValue. */
1473
1484
  interface CreateGuidanceValueRequirement {
@@ -1502,13 +1513,13 @@ interface CreateGuidanceRow {
1502
1513
  parentScoped: boolean;
1503
1514
  /** The fields the vendor accepted, in the order the vendor demanded them (live-proven). */
1504
1515
  liveProvenPrefix: string[];
1505
- /** True when the ladder consumed fields but the create still failed (e.g. opportunities — W-A5). */
1516
+ /** True when the ladder consumed fields but the create still failed (for example opportunities). */
1506
1517
  unproven: boolean;
1507
1518
  /** The structured blocker (null = none — a clean live-verified create). */
1508
1519
  blocker: CreateGuidanceBlocker | null;
1509
- /** The EXACT vendor message text observed (never paraphrased) + the correlation ids left out. */
1520
+ /** The EXACT vendor message text observed (never paraphrased) + the correlation ids left out, plus plain-text "maintainer provenance (...)" entries that record how a fact was established where no vendor message exists. */
1510
1521
  vendorEvidence: string[];
1511
- /** The spec-derived delete boundary (the W-A1 field on the same row). */
1522
+ /** The spec-derived delete boundary: whether the vendor defines a DELETE for this resource. A missing DELETE is a delete boundary, never a create blocker. */
1512
1523
  deleteBoundary: {
1513
1524
  available: boolean;
1514
1525
  note: string | null;
@@ -1520,8 +1531,10 @@ interface CreateGuidanceRow {
1520
1531
  rejectedValues?: CreateGuidanceRejectedValue[];
1521
1532
  /** The fields the vendor DERIVES for this resource (issue #219 N8): a submitted value is not authoritative. Distinct from readOnly — readOnly (the live field catalog's isReadOnly) means never write the field at all; derived means the vendor overwrites or inherits it. Absent = none declared. */
1522
1533
  derived?: DerivedField[];
1534
+ /** Where to read the company of a record whose model has no companyID of its own (issue #246): read the field on the resource record named by this resource's via field (tasks: projectID -> projects.companyID). Spec-derived and drift-guarded; absent = the resource has its own companyID or no scoping parent with one. */
1535
+ parentCompany?: CreateGuidanceParentCompany;
1523
1536
  }
1524
- /** The zone-fact create-guidance report (issue #12 — the served 92-entity catalog). */
1537
+ /** The zone-fact create-guidance report (issue #12 — the served create-guidance catalog). */
1525
1538
  interface CreateGuidanceReport {
1526
1539
  zone: string;
1527
1540
  label: string;
@@ -1587,11 +1600,22 @@ interface RelationshipResource {
1587
1600
  } | null;
1588
1601
  /** The plan-pinned zone facts (null = none pinned for this resource).
1589
1602
  * The createGuidance field (issue #12) is ADDITIVE: the relationship map
1590
- * keeps serving the existing createRequiredSet/quirks shape byte-for-
1591
- * byte; the wider served catalog is operations.createGuidance. */
1603
+ * keeps serving the existing createRequiredSet shape; the wider served
1604
+ * catalog is operations.createGuidance. */
1592
1605
  zoneFacts: {
1593
1606
  createRequiredSet?: string[];
1594
- quirks?: string[];
1607
+ /** Structured quirk entries (issue #253): a clean model-facing
1608
+ * statement, scoped by ops to the ops it constrains, with the verbatim
1609
+ * campaign string in evidence (the provenance home — exempt from the
1610
+ * clause 23 statement gate; the closed kind set + ops validation is
1611
+ * enforced by scripts/lib/checks/clause23-structured-quirks.mjs). */
1612
+ quirks?: Array<{
1613
+ kind: string;
1614
+ ops: string[];
1615
+ fields?: string[];
1616
+ statement: string;
1617
+ evidence: string;
1618
+ }>;
1595
1619
  /** Recorded successful live writes (issue #195) — the gate's liveness evidence. */
1596
1620
  liveWrites?: Array<{
1597
1621
  op: string;
@@ -1611,6 +1635,8 @@ interface RelationshipResource {
1611
1635
  remedy: string;
1612
1636
  /** The declared create requirement (issue #219 N3). */
1613
1637
  requires?: CreateGuidanceRequires;
1638
+ /** True when the API cannot satisfy this create for any input (issue #246). */
1639
+ unsatisfiableViaApi?: boolean;
1614
1640
  } | null;
1615
1641
  vendorEvidence: string[];
1616
1642
  deleteBoundary: {
@@ -1622,6 +1648,8 @@ interface RelationshipResource {
1622
1648
  requiresByValue?: CreateGuidanceValueRequirement[];
1623
1649
  /** Picklist values the vendor rejects (issue #219 N3). */
1624
1650
  rejectedValues?: CreateGuidanceRejectedValue[];
1651
+ /** Spec-derived parent-company hint (issue #246). */
1652
+ parentCompany?: CreateGuidanceParentCompany;
1625
1653
  };
1626
1654
  } | null;
1627
1655
  /** The spec-derived delete boundary (issue #9; null = the vendor defines a DELETE). */
@@ -2303,8 +2331,10 @@ declare class AppointmentsResource extends BaseResource<Appointment, Appointment
2303
2331
  queryAll(params?: AppointmentsResourceQueryParams): Promise<Appointment[]>;
2304
2332
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2305
2333
  count(params?: AppointmentsResourceQueryParams): Promise<number>;
2306
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2307
- get(id: Identifier): Promise<Appointment>;
2334
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2335
+ get(id: Identifier, opts?: {
2336
+ fresh?: boolean;
2337
+ } | null): Promise<Appointment>;
2308
2338
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
2309
2339
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2310
2340
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2366,8 +2396,10 @@ declare class BillingCodesResource extends BaseResource<BillingCode, BillingCode
2366
2396
  queryAll(params?: BillingCodesResourceQueryParams): Promise<BillingCode[]>;
2367
2397
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2368
2398
  count(params?: BillingCodesResourceQueryParams): Promise<number>;
2369
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2370
- get(id: Identifier): Promise<BillingCode>;
2399
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2400
+ get(id: Identifier, opts?: {
2401
+ fresh?: boolean;
2402
+ } | null): Promise<BillingCode>;
2371
2403
  /** Resolve a BillingCode from a numeric id (or, where the vendor indexes a primary text field,
2372
2404
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
2373
2405
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -2400,8 +2432,10 @@ declare class BillingItemApprovalLevelsResource extends BaseResource<BillingItem
2400
2432
  queryAll(params?: BillingItemApprovalLevelsResourceQueryParams): Promise<BillingItemApprovalLevel[]>;
2401
2433
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2402
2434
  count(params?: BillingItemApprovalLevelsResourceQueryParams): Promise<number>;
2403
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2404
- get(id: Identifier): Promise<BillingItemApprovalLevel>;
2435
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2436
+ get(id: Identifier, opts?: {
2437
+ fresh?: boolean;
2438
+ } | null): Promise<BillingItemApprovalLevel>;
2405
2439
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
2406
2440
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2407
2441
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2436,8 +2470,10 @@ declare class BillingItemsResource extends BaseResource<BillingItems, BillingIte
2436
2470
  queryAll(params?: BillingItemsResourceQueryParams): Promise<BillingItems[]>;
2437
2471
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2438
2472
  count(params?: BillingItemsResourceQueryParams): Promise<number>;
2439
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2440
- get(id: Identifier): Promise<BillingItems>;
2473
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2474
+ get(id: Identifier, opts?: {
2475
+ fresh?: boolean;
2476
+ } | null): Promise<BillingItems>;
2441
2477
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
2442
2478
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
2443
2479
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -2500,8 +2536,10 @@ declare class ChangeRequestLinksResource extends BaseResource<ChangeRequestLink,
2500
2536
  queryAll(params?: ChangeRequestLinksResourceQueryParams): Promise<ChangeRequestLink[]>;
2501
2537
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2502
2538
  count(params?: ChangeRequestLinksResourceQueryParams): Promise<number>;
2503
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2504
- get(id: Identifier): Promise<ChangeRequestLink>;
2539
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2540
+ get(id: Identifier, opts?: {
2541
+ fresh?: boolean;
2542
+ } | null): Promise<ChangeRequestLink>;
2505
2543
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
2506
2544
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2507
2545
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2538,8 +2576,10 @@ declare class ChecklistLibrariesResource extends BaseResource<ChecklistLibrary,
2538
2576
  queryAll(params?: ChecklistLibrariesResourceQueryParams): Promise<ChecklistLibrary[]>;
2539
2577
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2540
2578
  count(params?: ChecklistLibrariesResourceQueryParams): Promise<number>;
2541
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2542
- get(id: Identifier): Promise<ChecklistLibrary>;
2579
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2580
+ get(id: Identifier, opts?: {
2581
+ fresh?: boolean;
2582
+ } | null): Promise<ChecklistLibrary>;
2543
2583
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
2544
2584
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2545
2585
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2593,7 +2633,9 @@ declare class ChecklistLibraryChecklistItemsResource extends BaseResource<Checkl
2593
2633
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2594
2634
  count(params?: ChecklistLibraryChecklistItemsResourceQueryParams): Promise<number>;
2595
2635
  /** Get one record by parent + id (/V1.0/ChecklistLibraries/{parentId}/ChecklistItems/{id} — vendor item envelope; item: null → NotFoundError). */
2596
- get(parentId: Identifier, id: Identifier): Promise<ChecklistLibraryChecklistItem>;
2636
+ get(parentId: Identifier, id: Identifier, opts?: {
2637
+ fresh?: boolean;
2638
+ } | null): Promise<ChecklistLibraryChecklistItem>;
2597
2639
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
2598
2640
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2599
2641
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2635,8 +2677,10 @@ declare class ClassificationIconsResource extends BaseResource<ClassificationIco
2635
2677
  queryAll(params?: ClassificationIconsResourceQueryParams): Promise<ClassificationIcon[]>;
2636
2678
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2637
2679
  count(params?: ClassificationIconsResourceQueryParams): Promise<number>;
2638
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2639
- get(id: Identifier): Promise<ClassificationIcon>;
2680
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2681
+ get(id: Identifier, opts?: {
2682
+ fresh?: boolean;
2683
+ } | null): Promise<ClassificationIcon>;
2640
2684
  /** Resolve a ClassificationIcon from a numeric id (or, where the vendor indexes a primary text field,
2641
2685
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
2642
2686
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -2749,6 +2793,8 @@ interface TicketStatusOptions {
2749
2793
  fresh?: boolean;
2750
2794
  /** Explicit closed ids: the caller's override wins over the picklist and is reported as `picklist` (a caller decision is not an assumption). */
2751
2795
  excludeStatusIds?: readonly number[];
2796
+ /** Default true (unchanged behaviour). `false`: when the closed set cannot be resolved (picklist unreadable, or no closed label) throw `STATUS_SEMANTICS_UNRESOLVED` instead of returning the assumed `[5]`. An explicit `excludeStatusIds` is never an assumption. */
2797
+ allowAssumed?: boolean;
2752
2798
  }
2753
2799
 
2754
2800
  /** The list parts that accept a per-part field projection (issue #200). `company` is the single get and is not projectable. */
@@ -2772,6 +2818,10 @@ interface CompanyFullProfileOptions {
2772
2818
  names?: boolean;
2773
2819
  /** May LOWER the composite's name-read budget (default 20 — the count of COLD wire reads issued for name resolution; cache hits are free of the budget). The caller may lower it, never raise it; over-budget ids serve `name: null, capped: true` (never an error). */
2774
2820
  maxNameReads?: number;
2821
+ /** Explicit closed ticket-status ids for the openTickets part, overriding the resolved picklist (a caller decision, reported as source 'picklist'; same as tickets.forResource). */
2822
+ excludeStatusIds?: number[];
2823
+ /** `false` (default true, unchanged): throw `STATUS_SEMANTICS_UNRESOLVED` instead of falling back to the assumed closed id 5 when the tenant picklist cannot be resolved (issue #244). The throw happens at the openTickets read, after the company and the four other part reads. */
2824
+ allowAssumed?: boolean;
2775
2825
  }
2776
2826
  /** One capped list part (a full page sets `capped: true` — more may exist). */
2777
2827
  interface CompanyFullProfilePart<TItem> {
@@ -3029,8 +3079,10 @@ declare class CompaniesResource extends BaseResource<Company, CompanyCreate, Com
3029
3079
  queryAll(params?: CompaniesResourceQueryParams): Promise<Company[]>;
3030
3080
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3031
3081
  count(params?: CompaniesResourceQueryParams): Promise<number>;
3032
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3033
- get(id: Identifier): Promise<Company>;
3082
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3083
+ get(id: Identifier, opts?: {
3084
+ fresh?: boolean;
3085
+ } | null): Promise<Company>;
3034
3086
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3035
3087
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3036
3088
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3110,7 +3162,9 @@ declare class CompanyAlertsResource extends BaseResource<CompanyAlert, CompanyAl
3110
3162
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3111
3163
  count(params?: CompanyAlertsResourceQueryParams): Promise<number>;
3112
3164
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/Alerts/{id} — vendor item envelope; item: null → NotFoundError). */
3113
- get(parentId: Identifier, id: Identifier): Promise<CompanyAlert>;
3165
+ get(parentId: Identifier, id: Identifier, opts?: {
3166
+ fresh?: boolean;
3167
+ } | null): Promise<CompanyAlert>;
3114
3168
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3115
3169
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3116
3170
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3155,7 +3209,9 @@ declare class CompanyLocationsResource extends BaseResource<CompanyLocation, Com
3155
3209
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3156
3210
  count(params?: CompanyLocationsResourceQueryParams): Promise<number>;
3157
3211
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/Locations/{id} — vendor item envelope; item: null → NotFoundError). */
3158
- get(parentId: Identifier, id: Identifier): Promise<CompanyLocation>;
3212
+ get(parentId: Identifier, id: Identifier, opts?: {
3213
+ fresh?: boolean;
3214
+ } | null): Promise<CompanyLocation>;
3159
3215
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3160
3216
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3161
3217
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3204,7 +3260,9 @@ declare class CompanyNotesResource extends BaseResource<CompanyNote, CompanyNote
3204
3260
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3205
3261
  count(params?: CompanyNotesResourceQueryParams): Promise<number>;
3206
3262
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
3207
- get(parentId: Identifier, id: Identifier): Promise<CompanyNote>;
3263
+ get(parentId: Identifier, id: Identifier, opts?: {
3264
+ fresh?: boolean;
3265
+ } | null): Promise<CompanyNote>;
3208
3266
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3209
3267
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3210
3268
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3250,7 +3308,9 @@ declare class CompanySiteConfigurationsResource extends BaseResource<CompanySite
3250
3308
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3251
3309
  count(params?: CompanySiteConfigurationsResourceQueryParams): Promise<number>;
3252
3310
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/SiteConfigurations/{id} — vendor item envelope; item: null → NotFoundError). */
3253
- get(parentId: Identifier, id: Identifier): Promise<CompanySiteConfigurations>;
3311
+ get(parentId: Identifier, id: Identifier, opts?: {
3312
+ fresh?: boolean;
3313
+ } | null): Promise<CompanySiteConfigurations>;
3254
3314
  /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
3255
3315
  * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
3256
3316
  * the pinned envelope with the best-effort diff; a caller-supplied lastModifiedDate that
@@ -3286,8 +3346,10 @@ declare class CompanyWebhooksResource extends BaseResource<CompanyWebhook, Compa
3286
3346
  queryAll(params?: CompanyWebhooksResourceQueryParams): Promise<CompanyWebhook[]>;
3287
3347
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3288
3348
  count(params?: CompanyWebhooksResourceQueryParams): Promise<number>;
3289
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3290
- get(id: Identifier): Promise<CompanyWebhook>;
3349
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3350
+ get(id: Identifier, opts?: {
3351
+ fresh?: boolean;
3352
+ } | null): Promise<CompanyWebhook>;
3291
3353
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3292
3354
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3293
3355
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3341,7 +3403,9 @@ declare class ConfigurationItemBillingProductAssociationsResource extends BaseRe
3341
3403
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3342
3404
  count(params?: ConfigurationItemBillingProductAssociationsResourceQueryParams): Promise<number>;
3343
3405
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/BillingProductAssociations/{id} — vendor item envelope; item: null → NotFoundError). */
3344
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemBillingProductAssociations>;
3406
+ get(parentId: Identifier, id: Identifier, opts?: {
3407
+ fresh?: boolean;
3408
+ } | null): Promise<ConfigurationItemBillingProductAssociations>;
3345
3409
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3346
3410
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3347
3411
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3383,8 +3447,10 @@ declare class ConfigurationItemCategoriesResource extends BaseResource<Configura
3383
3447
  queryAll(params?: ConfigurationItemCategoriesResourceQueryParams): Promise<ConfigurationItemCategory[]>;
3384
3448
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3385
3449
  count(params?: ConfigurationItemCategoriesResourceQueryParams): Promise<number>;
3386
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3387
- get(id: Identifier): Promise<ConfigurationItemCategory>;
3450
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3451
+ get(id: Identifier, opts?: {
3452
+ fresh?: boolean;
3453
+ } | null): Promise<ConfigurationItemCategory>;
3388
3454
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3389
3455
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3390
3456
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3435,7 +3501,9 @@ declare class ConfigurationItemCategoryUdfAssociationsResource extends BaseResou
3435
3501
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3436
3502
  count(params?: ConfigurationItemCategoryUdfAssociationsResourceQueryParams): Promise<number>;
3437
3503
  /** Get one record by parent + id (/V1.0/ConfigurationItemCategories/{parentId}/UdfAssociations/{id} — vendor item envelope; item: null → NotFoundError). */
3438
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemCategoryUdfAssociation>;
3504
+ get(parentId: Identifier, id: Identifier, opts?: {
3505
+ fresh?: boolean;
3506
+ } | null): Promise<ConfigurationItemCategoryUdfAssociation>;
3439
3507
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3440
3508
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3441
3509
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3480,7 +3548,9 @@ declare class ConfigurationItemDnsRecordsResource extends BaseResource<Configura
3480
3548
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3481
3549
  count(params?: ConfigurationItemDnsRecordsResourceQueryParams): Promise<number>;
3482
3550
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/DnsRecords/{id} — vendor item envelope; item: null → NotFoundError). */
3483
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemDnsRecord>;
3551
+ get(parentId: Identifier, id: Identifier, opts?: {
3552
+ fresh?: boolean;
3553
+ } | null): Promise<ConfigurationItemDnsRecord>;
3484
3554
  /** Delete a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the pinned
3485
3555
  * envelope and never issues the delete. */
3486
3556
  delete(parentId: Identifier, id: Identifier, opts?: MutationOpts): Promise<OperationResult | DryRunResult<Record<string, unknown>>>;
@@ -3515,7 +3585,9 @@ declare class ConfigurationItemNotesResource extends BaseResource<ConfigurationI
3515
3585
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3516
3586
  count(params?: ConfigurationItemNotesResourceQueryParams): Promise<number>;
3517
3587
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
3518
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemNote>;
3588
+ get(parentId: Identifier, id: Identifier, opts?: {
3589
+ fresh?: boolean;
3590
+ } | null): Promise<ConfigurationItemNote>;
3519
3591
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3520
3592
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3521
3593
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3557,7 +3629,9 @@ declare class ConfigurationItemRelatedItemsResource extends BaseResource<Configu
3557
3629
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3558
3630
  count(params?: ConfigurationItemRelatedItemsResourceQueryParams): Promise<number>;
3559
3631
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/RelatedItems/{id} — vendor item envelope; item: null → NotFoundError). */
3560
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemRelatedItem>;
3632
+ get(parentId: Identifier, id: Identifier, opts?: {
3633
+ fresh?: boolean;
3634
+ } | null): Promise<ConfigurationItemRelatedItem>;
3561
3635
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3562
3636
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3563
3637
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3680,8 +3754,10 @@ declare class ConfigurationItemsResource extends BaseResource<ConfigurationItem,
3680
3754
  queryAll(params?: ConfigurationItemsResourceQueryParams): Promise<ConfigurationItem[]>;
3681
3755
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3682
3756
  count(params?: ConfigurationItemsResourceQueryParams): Promise<number>;
3683
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3684
- get(id: Identifier): Promise<ConfigurationItem>;
3757
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3758
+ get(id: Identifier, opts?: {
3759
+ fresh?: boolean;
3760
+ } | null): Promise<ConfigurationItem>;
3685
3761
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3686
3762
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3687
3763
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3741,7 +3817,9 @@ declare class ConfigurationItemSslSubjectAlternativeNamesResource extends BaseRe
3741
3817
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3742
3818
  count(params?: ConfigurationItemSslSubjectAlternativeNamesResourceQueryParams): Promise<number>;
3743
3819
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/SslSubjectAlternativeNames/{id} — vendor item envelope; item: null → NotFoundError). */
3744
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemSslSubjectAlternativeName>;
3820
+ get(parentId: Identifier, id: Identifier, opts?: {
3821
+ fresh?: boolean;
3822
+ } | null): Promise<ConfigurationItemSslSubjectAlternativeName>;
3745
3823
  /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
3746
3824
  * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
3747
3825
  * the pinned envelope with the best-effort diff; a caller-supplied lastModifiedDate that
@@ -3782,8 +3860,10 @@ declare class ConfigurationItemTypesResource extends BaseResource<ConfigurationI
3782
3860
  queryAll(params?: ConfigurationItemTypesResourceQueryParams): Promise<ConfigurationItemType[]>;
3783
3861
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3784
3862
  count(params?: ConfigurationItemTypesResourceQueryParams): Promise<number>;
3785
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3786
- get(id: Identifier): Promise<ConfigurationItemType>;
3863
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3864
+ get(id: Identifier, opts?: {
3865
+ fresh?: boolean;
3866
+ } | null): Promise<ConfigurationItemType>;
3787
3867
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3788
3868
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3789
3869
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3836,8 +3916,10 @@ declare class ConfigurationItemWebhooksResource extends BaseResource<Configurati
3836
3916
  queryAll(params?: ConfigurationItemWebhooksResourceQueryParams): Promise<ConfigurationItemWebhook[]>;
3837
3917
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3838
3918
  count(params?: ConfigurationItemWebhooksResourceQueryParams): Promise<number>;
3839
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3840
- get(id: Identifier): Promise<ConfigurationItemWebhook>;
3919
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3920
+ get(id: Identifier, opts?: {
3921
+ fresh?: boolean;
3922
+ } | null): Promise<ConfigurationItemWebhook>;
3841
3923
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3842
3924
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3843
3925
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3888,8 +3970,10 @@ declare class ContactGroupContactsResource extends BaseResource<ContactGroupCont
3888
3970
  queryAll(params?: ContactGroupContactsResourceQueryParams): Promise<ContactGroupContacts[]>;
3889
3971
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3890
3972
  count(params?: ContactGroupContactsResourceQueryParams): Promise<number>;
3891
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3892
- get(id: Identifier): Promise<ContactGroupContacts>;
3973
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3974
+ get(id: Identifier, opts?: {
3975
+ fresh?: boolean;
3976
+ } | null): Promise<ContactGroupContacts>;
3893
3977
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3894
3978
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3895
3979
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3926,8 +4010,10 @@ declare class ContactGroupsResource extends BaseResource<ContactGroups, ContactG
3926
4010
  queryAll(params?: ContactGroupsResourceQueryParams): Promise<ContactGroups[]>;
3927
4011
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3928
4012
  count(params?: ContactGroupsResourceQueryParams): Promise<number>;
3929
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3930
- get(id: Identifier): Promise<ContactGroups>;
4013
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
4014
+ get(id: Identifier, opts?: {
4015
+ fresh?: boolean;
4016
+ } | null): Promise<ContactGroups>;
3931
4017
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3932
4018
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3933
4019
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4038,7 +4124,9 @@ declare class ContactsResource extends BaseResource<Contact, ContactCreate, Cont
4038
4124
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4039
4125
  count(params?: ContactsResourceQueryParams): Promise<number>;
4040
4126
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/Contacts/{id} — vendor item envelope; item: null → NotFoundError). */
4041
- get(parentId: Identifier, id: Identifier): Promise<Contact>;
4127
+ get(parentId: Identifier, id: Identifier, opts?: {
4128
+ fresh?: boolean;
4129
+ } | null): Promise<Contact>;
4042
4130
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4043
4131
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4044
4132
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4095,8 +4183,10 @@ declare class ContactWebhooksResource extends BaseResource<ContactWebhook, Conta
4095
4183
  queryAll(params?: ContactWebhooksResourceQueryParams): Promise<ContactWebhook[]>;
4096
4184
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4097
4185
  count(params?: ContactWebhooksResourceQueryParams): Promise<number>;
4098
- /** Get one record by id (item envelope; item: null → NotFoundError). */
4099
- get(id: Identifier): Promise<ContactWebhook>;
4186
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
4187
+ get(id: Identifier, opts?: {
4188
+ fresh?: boolean;
4189
+ } | null): Promise<ContactWebhook>;
4100
4190
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
4101
4191
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4102
4192
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4150,7 +4240,9 @@ declare class ContractBillingRulesResource extends BaseResource<ContractBillingR
4150
4240
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4151
4241
  count(params?: ContractBillingRulesResourceQueryParams): Promise<number>;
4152
4242
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/BillingRules/{id} — vendor item envelope; item: null → NotFoundError). */
4153
- get(parentId: Identifier, id: Identifier): Promise<ContractBillingRule>;
4243
+ get(parentId: Identifier, id: Identifier, opts?: {
4244
+ fresh?: boolean;
4245
+ } | null): Promise<ContractBillingRule>;
4154
4246
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4155
4247
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4156
4248
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4195,7 +4287,9 @@ declare class ContractBlockHourFactorsResource extends BaseResource<ContractBloc
4195
4287
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4196
4288
  count(params?: ContractBlockHourFactorsResourceQueryParams): Promise<number>;
4197
4289
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/BlockHourFactors/{id} — vendor item envelope; item: null → NotFoundError). */
4198
- get(parentId: Identifier, id: Identifier): Promise<ContractBlockHourFactor>;
4290
+ get(parentId: Identifier, id: Identifier, opts?: {
4291
+ fresh?: boolean;
4292
+ } | null): Promise<ContractBlockHourFactor>;
4199
4293
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4200
4294
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4201
4295
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4237,7 +4331,9 @@ declare class ContractBlocksResource extends BaseResource<ContractBlock, Contrac
4237
4331
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4238
4332
  count(params?: ContractBlocksResourceQueryParams): Promise<number>;
4239
4333
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Blocks/{id} — vendor item envelope; item: null → NotFoundError). */
4240
- get(parentId: Identifier, id: Identifier): Promise<ContractBlock>;
4334
+ get(parentId: Identifier, id: Identifier, opts?: {
4335
+ fresh?: boolean;
4336
+ } | null): Promise<ContractBlock>;
4241
4337
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4242
4338
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4243
4339
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4279,7 +4375,9 @@ declare class ContractChargesResource extends BaseResource<ContractCharge, Contr
4279
4375
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4280
4376
  count(params?: ContractChargesResourceQueryParams): Promise<number>;
4281
4377
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
4282
- get(parentId: Identifier, id: Identifier): Promise<ContractCharge>;
4378
+ get(parentId: Identifier, id: Identifier, opts?: {
4379
+ fresh?: boolean;
4380
+ } | null): Promise<ContractCharge>;
4283
4381
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4284
4382
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4285
4383
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4328,7 +4426,9 @@ declare class ContractExclusionBillingCodesResource extends BaseResource<Contrac
4328
4426
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4329
4427
  count(params?: ContractExclusionBillingCodesResourceQueryParams): Promise<number>;
4330
4428
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ExclusionBillingCodes/{id} — vendor item envelope; item: null → NotFoundError). */
4331
- get(parentId: Identifier, id: Identifier): Promise<ContractExclusionBillingCode>;
4429
+ get(parentId: Identifier, id: Identifier, opts?: {
4430
+ fresh?: boolean;
4431
+ } | null): Promise<ContractExclusionBillingCode>;
4332
4432
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4333
4433
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4334
4434
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4368,7 +4468,9 @@ declare class ContractExclusionRolesResource extends BaseResource<ContractExclus
4368
4468
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4369
4469
  count(params?: ContractExclusionRolesResourceQueryParams): Promise<number>;
4370
4470
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ExclusionRoles/{id} — vendor item envelope; item: null → NotFoundError). */
4371
- get(parentId: Identifier, id: Identifier): Promise<ContractExclusionRoles>;
4471
+ get(parentId: Identifier, id: Identifier, opts?: {
4472
+ fresh?: boolean;
4473
+ } | null): Promise<ContractExclusionRoles>;
4372
4474
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4373
4475
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4374
4476
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4408,7 +4510,9 @@ declare class ContractExclusionSetExcludedRolesResource extends BaseResource<Con
4408
4510
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4409
4511
  count(params?: ContractExclusionSetExcludedRolesResourceQueryParams): Promise<number>;
4410
4512
  /** Get one record by parent + id (/V1.0/ContractExclusionSets/{parentId}/ExcludedRoles/{id} — vendor item envelope; item: null → NotFoundError). */
4411
- get(parentId: Identifier, id: Identifier): Promise<ContractExclusionSetExcludedRoles>;
4513
+ get(parentId: Identifier, id: Identifier, opts?: {
4514
+ fresh?: boolean;
4515
+ } | null): Promise<ContractExclusionSetExcludedRoles>;
4412
4516
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4413
4517
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4414
4518
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4448,7 +4552,9 @@ declare class ContractExclusionSetExcludedWorkTypesResource extends BaseResource
4448
4552
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4449
4553
  count(params?: ContractExclusionSetExcludedWorkTypesResourceQueryParams): Promise<number>;
4450
4554
  /** Get one record by parent + id (/V1.0/ContractExclusionSets/{parentId}/ExcludedWorkTypes/{id} — vendor item envelope; item: null → NotFoundError). */
4451
- get(parentId: Identifier, id: Identifier): Promise<ContractExclusionSetExcludedWorkTypes>;
4555
+ get(parentId: Identifier, id: Identifier, opts?: {
4556
+ fresh?: boolean;
4557
+ } | null): Promise<ContractExclusionSetExcludedWorkTypes>;
4452
4558
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4453
4559
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4454
4560
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4485,8 +4591,10 @@ declare class ContractExclusionSetsResource extends BaseResource<ContractExclusi
4485
4591
  queryAll(params?: ContractExclusionSetsResourceQueryParams): Promise<ContractExclusionSets[]>;
4486
4592
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4487
4593
  count(params?: ContractExclusionSetsResourceQueryParams): Promise<number>;
4488
- /** Get one record by id (item envelope; item: null → NotFoundError). */
4489
- get(id: Identifier): Promise<ContractExclusionSets>;
4594
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
4595
+ get(id: Identifier, opts?: {
4596
+ fresh?: boolean;
4597
+ } | null): Promise<ContractExclusionSets>;
4490
4598
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
4491
4599
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4492
4600
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4540,7 +4648,9 @@ declare class ContractMilestonesResource extends BaseResource<ContractMilestone,
4540
4648
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4541
4649
  count(params?: ContractMilestonesResourceQueryParams): Promise<number>;
4542
4650
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Milestones/{id} — vendor item envelope; item: null → NotFoundError). */
4543
- get(parentId: Identifier, id: Identifier): Promise<ContractMilestone>;
4651
+ get(parentId: Identifier, id: Identifier, opts?: {
4652
+ fresh?: boolean;
4653
+ } | null): Promise<ContractMilestone>;
4544
4654
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4545
4655
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4546
4656
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4582,7 +4692,9 @@ declare class ContractNotesResource extends BaseResource<ContractNote, ContractN
4582
4692
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4583
4693
  count(params?: ContractNotesResourceQueryParams): Promise<number>;
4584
4694
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
4585
- get(parentId: Identifier, id: Identifier): Promise<ContractNote>;
4695
+ get(parentId: Identifier, id: Identifier, opts?: {
4696
+ fresh?: boolean;
4697
+ } | null): Promise<ContractNote>;
4586
4698
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4587
4699
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4588
4700
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4624,7 +4736,9 @@ declare class ContractRatesResource extends BaseResource<ContractRate, ContractR
4624
4736
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4625
4737
  count(params?: ContractRatesResourceQueryParams): Promise<number>;
4626
4738
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Rates/{id} — vendor item envelope; item: null → NotFoundError). */
4627
- get(parentId: Identifier, id: Identifier): Promise<ContractRate>;
4739
+ get(parentId: Identifier, id: Identifier, opts?: {
4740
+ fresh?: boolean;
4741
+ } | null): Promise<ContractRate>;
4628
4742
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4629
4743
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4630
4744
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4666,7 +4780,9 @@ declare class ContractRetainersResource extends BaseResource<ContractRetainers,
4666
4780
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4667
4781
  count(params?: ContractRetainersResourceQueryParams): Promise<number>;
4668
4782
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Retainers/{id} — vendor item envelope; item: null → NotFoundError). */
4669
- get(parentId: Identifier, id: Identifier): Promise<ContractRetainers>;
4783
+ get(parentId: Identifier, id: Identifier, opts?: {
4784
+ fresh?: boolean;
4785
+ } | null): Promise<ContractRetainers>;
4670
4786
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4671
4787
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4672
4788
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4708,7 +4824,9 @@ declare class ContractRoleCostsResource extends BaseResource<ContractRoleCosts,
4708
4824
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4709
4825
  count(params?: ContractRoleCostsResourceQueryParams): Promise<number>;
4710
4826
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/RoleCosts/{id} — vendor item envelope; item: null → NotFoundError). */
4711
- get(parentId: Identifier, id: Identifier): Promise<ContractRoleCosts>;
4827
+ get(parentId: Identifier, id: Identifier, opts?: {
4828
+ fresh?: boolean;
4829
+ } | null): Promise<ContractRoleCosts>;
4712
4830
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4713
4831
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4714
4832
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4808,7 +4926,9 @@ declare class ContractServiceBundlesResource extends BaseResource<ContractServic
4808
4926
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4809
4927
  count(params?: ContractServiceBundlesResourceQueryParams): Promise<number>;
4810
4928
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceBundles/{id} — vendor item envelope; item: null → NotFoundError). */
4811
- get(parentId: Identifier, id: Identifier): Promise<ContractServiceBundle>;
4929
+ get(parentId: Identifier, id: Identifier, opts?: {
4930
+ fresh?: boolean;
4931
+ } | null): Promise<ContractServiceBundle>;
4812
4932
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4813
4933
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4814
4934
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4850,7 +4970,9 @@ declare class ContractServiceBundleUnitsResource extends BaseResource<ContractSe
4850
4970
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4851
4971
  count(params?: ContractServiceBundleUnitsResourceQueryParams): Promise<number>;
4852
4972
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceBundleUnits/{id} — vendor item envelope; item: null → NotFoundError). */
4853
- get(parentId: Identifier, id: Identifier): Promise<ContractServiceBundleUnit>;
4973
+ get(parentId: Identifier, id: Identifier, opts?: {
4974
+ fresh?: boolean;
4975
+ } | null): Promise<ContractServiceBundleUnit>;
4854
4976
  /** Resolve a ContractServiceBundleUnit from a numeric id (or, where the vendor indexes a primary text field,
4855
4977
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
4856
4978
  * a bare value rejects with a config error (ids only);
@@ -4882,7 +5004,9 @@ declare class ContractServicesResource extends BaseResource<ContractService, Con
4882
5004
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4883
5005
  count(params?: ContractServicesResourceQueryParams): Promise<number>;
4884
5006
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Services/{id} — vendor item envelope; item: null → NotFoundError). */
4885
- get(parentId: Identifier, id: Identifier): Promise<ContractService>;
5007
+ get(parentId: Identifier, id: Identifier, opts?: {
5008
+ fresh?: boolean;
5009
+ } | null): Promise<ContractService>;
4886
5010
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4887
5011
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4888
5012
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4924,7 +5048,9 @@ declare class ContractServiceUnitsResource extends BaseResource<ContractServiceU
4924
5048
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4925
5049
  count(params?: ContractServiceUnitsResourceQueryParams): Promise<number>;
4926
5050
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceUnits/{id} — vendor item envelope; item: null → NotFoundError). */
4927
- get(parentId: Identifier, id: Identifier): Promise<ContractServiceUnit>;
5051
+ get(parentId: Identifier, id: Identifier, opts?: {
5052
+ fresh?: boolean;
5053
+ } | null): Promise<ContractServiceUnit>;
4928
5054
  /** Resolve a ContractServiceUnit from a numeric id (or, where the vendor indexes a primary text field,
4929
5055
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
4930
5056
  * a bare value rejects with a config error (ids only);
@@ -5230,8 +5356,10 @@ declare class ContractsResource extends BaseResource<Contract, ContractCreate, C
5230
5356
  queryAll(params?: ContractsResourceQueryParams): Promise<Contract[]>;
5231
5357
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5232
5358
  count(params?: ContractsResourceQueryParams): Promise<number>;
5233
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5234
- get(id: Identifier): Promise<Contract>;
5359
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5360
+ get(id: Identifier, opts?: {
5361
+ fresh?: boolean;
5362
+ } | null): Promise<Contract>;
5235
5363
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5236
5364
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5237
5365
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5286,7 +5414,9 @@ declare class ContractTicketPurchasesResource extends BaseResource<ContractTicke
5286
5414
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5287
5415
  count(params?: ContractTicketPurchasesResourceQueryParams): Promise<number>;
5288
5416
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/TicketPurchases/{id} — vendor item envelope; item: null → NotFoundError). */
5289
- get(parentId: Identifier, id: Identifier): Promise<ContractTicketPurchases>;
5417
+ get(parentId: Identifier, id: Identifier, opts?: {
5418
+ fresh?: boolean;
5419
+ } | null): Promise<ContractTicketPurchases>;
5290
5420
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5291
5421
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5292
5422
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5325,8 +5455,10 @@ declare class CountriesResource extends BaseResource<Country, CountryCreate, Cou
5325
5455
  queryAll(params?: CountriesResourceQueryParams): Promise<Country[]>;
5326
5456
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5327
5457
  count(params?: CountriesResourceQueryParams): Promise<number>;
5328
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5329
- get(id: Identifier): Promise<Country>;
5458
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5459
+ get(id: Identifier, opts?: {
5460
+ fresh?: boolean;
5461
+ } | null): Promise<Country>;
5330
5462
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
5331
5463
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
5332
5464
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -5369,8 +5501,10 @@ declare class CurrenciesResource extends BaseResource<Currency, CurrencyCreate,
5369
5501
  queryAll(params?: CurrenciesResourceQueryParams): Promise<Currency[]>;
5370
5502
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5371
5503
  count(params?: CurrenciesResourceQueryParams): Promise<number>;
5372
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5373
- get(id: Identifier): Promise<Currency>;
5504
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5505
+ get(id: Identifier, opts?: {
5506
+ fresh?: boolean;
5507
+ } | null): Promise<Currency>;
5374
5508
  /** Resolve a Currency from a numeric id (or, where the vendor indexes a primary text field,
5375
5509
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
5376
5510
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -5403,8 +5537,10 @@ declare class DepartmentsResource extends BaseResource<Department, DepartmentCre
5403
5537
  queryAll(params?: DepartmentsResourceQueryParams): Promise<Department[]>;
5404
5538
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5405
5539
  count(params?: DepartmentsResourceQueryParams): Promise<number>;
5406
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5407
- get(id: Identifier): Promise<Department>;
5540
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5541
+ get(id: Identifier, opts?: {
5542
+ fresh?: boolean;
5543
+ } | null): Promise<Department>;
5408
5544
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5409
5545
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5410
5546
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5452,8 +5588,10 @@ declare class DomainRegistrarsResource extends BaseResource<DomainRegistrar, Dom
5452
5588
  queryAll(params?: DomainRegistrarsResourceQueryParams): Promise<DomainRegistrar[]>;
5453
5589
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5454
5590
  count(params?: DomainRegistrarsResourceQueryParams): Promise<number>;
5455
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5456
- get(id: Identifier): Promise<DomainRegistrar>;
5591
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5592
+ get(id: Identifier, opts?: {
5593
+ fresh?: boolean;
5594
+ } | null): Promise<DomainRegistrar>;
5457
5595
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5458
5596
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5459
5597
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5519,7 +5657,9 @@ declare class ExpenseItemAttachmentsResource extends BaseResource<ExpenseItemAtt
5519
5657
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5520
5658
  count(params?: ExpenseItemAttachmentsResourceQueryParams): Promise<number>;
5521
5659
  /** Get one record by parent + id (/V1.0/ExpenseItems/{parentId}/Attachments/{id} — vendor answers the model directly). */
5522
- get(parentId: Identifier, id: Identifier): Promise<ExpenseItemAttachment>;
5660
+ get(parentId: Identifier, id: Identifier, opts?: {
5661
+ fresh?: boolean;
5662
+ } | null): Promise<ExpenseItemAttachment>;
5523
5663
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5524
5664
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5525
5665
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5560,8 +5700,10 @@ declare class ExpenseItemsResource extends BaseResource<ExpenseItem, ExpenseItem
5560
5700
  queryAll(params?: ExpenseItemsResourceQueryParams): Promise<ExpenseItem[]>;
5561
5701
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5562
5702
  count(params?: ExpenseItemsResourceQueryParams): Promise<number>;
5563
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5564
- get(id: Identifier): Promise<ExpenseItem>;
5703
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5704
+ get(id: Identifier, opts?: {
5705
+ fresh?: boolean;
5706
+ } | null): Promise<ExpenseItem>;
5565
5707
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5566
5708
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5567
5709
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5600,8 +5742,10 @@ declare class ExpenseReportsResource extends BaseResource<ExpenseReport, Expense
5600
5742
  queryAll(params?: ExpenseReportsResourceQueryParams): Promise<ExpenseReport[]>;
5601
5743
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5602
5744
  count(params?: ExpenseReportsResourceQueryParams): Promise<number>;
5603
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5604
- get(id: Identifier): Promise<ExpenseReport>;
5745
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5746
+ get(id: Identifier, opts?: {
5747
+ fresh?: boolean;
5748
+ } | null): Promise<ExpenseReport>;
5605
5749
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5606
5750
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5607
5751
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5649,8 +5793,10 @@ declare class HolidaySetsResource extends BaseResource<HolidaySet, HolidaySetCre
5649
5793
  queryAll(params?: HolidaySetsResourceQueryParams): Promise<HolidaySet[]>;
5650
5794
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5651
5795
  count(params?: HolidaySetsResourceQueryParams): Promise<number>;
5652
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5653
- get(id: Identifier): Promise<HolidaySet>;
5796
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5797
+ get(id: Identifier, opts?: {
5798
+ fresh?: boolean;
5799
+ } | null): Promise<HolidaySet>;
5654
5800
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5655
5801
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5656
5802
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5700,7 +5846,9 @@ declare class HolidaysResource extends BaseResource<Holiday, HolidayCreate, Holi
5700
5846
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5701
5847
  count(params?: HolidaysResourceQueryParams): Promise<number>;
5702
5848
  /** Get one record by parent + id (/V1.0/HolidaySets/{parentId}/Holidays/{id} — vendor item envelope; item: null → NotFoundError). */
5703
- get(parentId: Identifier, id: Identifier): Promise<Holiday>;
5849
+ get(parentId: Identifier, id: Identifier, opts?: {
5850
+ fresh?: boolean;
5851
+ } | null): Promise<Holiday>;
5704
5852
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5705
5853
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5706
5854
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5742,8 +5890,10 @@ declare class InventoryProductsResource extends BaseResource<InventoryProduct, I
5742
5890
  queryAll(params?: InventoryProductsResourceQueryParams): Promise<InventoryProduct[]>;
5743
5891
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5744
5892
  count(params?: InventoryProductsResourceQueryParams): Promise<number>;
5745
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5746
- get(id: Identifier): Promise<InventoryProduct>;
5893
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5894
+ get(id: Identifier, opts?: {
5895
+ fresh?: boolean;
5896
+ } | null): Promise<InventoryProduct>;
5747
5897
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5748
5898
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5749
5899
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5796,8 +5946,10 @@ declare class InvoicesResource extends BaseResource<Invoice, InvoiceCreate, Invo
5796
5946
  queryAll(params?: InvoicesResourceQueryParams): Promise<Invoice[]>;
5797
5947
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5798
5948
  count(params?: InvoicesResourceQueryParams): Promise<number>;
5799
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5800
- get(id: Identifier): Promise<Invoice>;
5949
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5950
+ get(id: Identifier, opts?: {
5951
+ fresh?: boolean;
5952
+ } | null): Promise<Invoice>;
5801
5953
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
5802
5954
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
5803
5955
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -5866,8 +6018,10 @@ declare class InvoiceTemplatesResource extends BaseResource<InvoiceTemplate, Inv
5866
6018
  queryAll(params?: InvoiceTemplatesResourceQueryParams): Promise<InvoiceTemplate[]>;
5867
6019
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5868
6020
  count(params?: InvoiceTemplatesResourceQueryParams): Promise<number>;
5869
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5870
- get(id: Identifier): Promise<InvoiceTemplate>;
6021
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6022
+ get(id: Identifier, opts?: {
6023
+ fresh?: boolean;
6024
+ } | null): Promise<InvoiceTemplate>;
5871
6025
  }
5872
6026
 
5873
6027
  /**
@@ -5901,8 +6055,10 @@ declare class NotificationHistoryResource extends BaseResource<NotificationHisto
5901
6055
  queryAll(params?: NotificationHistoryResourceQueryParams): Promise<NotificationHistory[]>;
5902
6056
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5903
6057
  count(params?: NotificationHistoryResourceQueryParams): Promise<number>;
5904
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5905
- get(id: Identifier): Promise<NotificationHistory>;
6058
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6059
+ get(id: Identifier, opts?: {
6060
+ fresh?: boolean;
6061
+ } | null): Promise<NotificationHistory>;
5906
6062
  /** Resolve a NotificationHistory from a numeric id (or, where the vendor indexes a primary text field,
5907
6063
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
5908
6064
  * a bare value rejects with a config error (ids only);
@@ -5931,8 +6087,10 @@ declare class OpportunitiesResource extends BaseResource<Opportunity, Opportunit
5931
6087
  queryAll(params?: OpportunitiesResourceQueryParams): Promise<Opportunity[]>;
5932
6088
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5933
6089
  count(params?: OpportunitiesResourceQueryParams): Promise<number>;
5934
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5935
- get(id: Identifier): Promise<Opportunity>;
6090
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6091
+ get(id: Identifier, opts?: {
6092
+ fresh?: boolean;
6093
+ } | null): Promise<Opportunity>;
5936
6094
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5937
6095
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5938
6096
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5979,7 +6137,9 @@ declare class OpportunityAttachmentsResource extends BaseResource<OpportunityAtt
5979
6137
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5980
6138
  count(params?: OpportunityAttachmentsResourceQueryParams): Promise<number>;
5981
6139
  /** Get one record by parent + id (/V1.0/Opportunities/{parentId}/Attachments/{id} — vendor answers the model directly). */
5982
- get(parentId: Identifier, id: Identifier): Promise<OpportunityAttachment>;
6140
+ get(parentId: Identifier, id: Identifier, opts?: {
6141
+ fresh?: boolean;
6142
+ } | null): Promise<OpportunityAttachment>;
5983
6143
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5984
6144
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5985
6145
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6018,8 +6178,10 @@ declare class OpportunityCategoriesResource extends BaseResource<OpportunityCate
6018
6178
  queryAll(params?: OpportunityCategoriesResourceQueryParams): Promise<OpportunityCategory[]>;
6019
6179
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6020
6180
  count(params?: OpportunityCategoriesResourceQueryParams): Promise<number>;
6021
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6022
- get(id: Identifier): Promise<OpportunityCategory>;
6181
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6182
+ get(id: Identifier, opts?: {
6183
+ fresh?: boolean;
6184
+ } | null): Promise<OpportunityCategory>;
6023
6185
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
6024
6186
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
6025
6187
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -6062,8 +6224,10 @@ declare class OrganizationalLevel1sResource extends BaseResource<OrganizationalL
6062
6224
  queryAll(params?: OrganizationalLevel1sResourceQueryParams): Promise<OrganizationalLevel1[]>;
6063
6225
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6064
6226
  count(params?: OrganizationalLevel1sResourceQueryParams): Promise<number>;
6065
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6066
- get(id: Identifier): Promise<OrganizationalLevel1>;
6227
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6228
+ get(id: Identifier, opts?: {
6229
+ fresh?: boolean;
6230
+ } | null): Promise<OrganizationalLevel1>;
6067
6231
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6068
6232
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6069
6233
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6097,8 +6261,10 @@ declare class OrganizationalLevel2sResource extends BaseResource<OrganizationalL
6097
6261
  queryAll(params?: OrganizationalLevel2sResourceQueryParams): Promise<OrganizationalLevel2[]>;
6098
6262
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6099
6263
  count(params?: OrganizationalLevel2sResourceQueryParams): Promise<number>;
6100
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6101
- get(id: Identifier): Promise<OrganizationalLevel2>;
6264
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6265
+ get(id: Identifier, opts?: {
6266
+ fresh?: boolean;
6267
+ } | null): Promise<OrganizationalLevel2>;
6102
6268
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6103
6269
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6104
6270
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6132,8 +6298,10 @@ declare class OrganizationalLevelAssociationsResource extends BaseResource<Organ
6132
6298
  queryAll(params?: OrganizationalLevelAssociationsResourceQueryParams): Promise<OrganizationalLevelAssociation[]>;
6133
6299
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6134
6300
  count(params?: OrganizationalLevelAssociationsResourceQueryParams): Promise<number>;
6135
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6136
- get(id: Identifier): Promise<OrganizationalLevelAssociation>;
6301
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6302
+ get(id: Identifier, opts?: {
6303
+ fresh?: boolean;
6304
+ } | null): Promise<OrganizationalLevelAssociation>;
6137
6305
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6138
6306
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6139
6307
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6170,7 +6338,9 @@ declare class PhasesResource extends BaseResource<Phase, PhaseCreate, PhaseUpdat
6170
6338
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6171
6339
  count(params?: PhasesResourceQueryParams): Promise<number>;
6172
6340
  /** Get one record by parent + id (/V1.0/Projects/{parentId}/Phases/{id} — vendor item envelope; item: null → NotFoundError). */
6173
- get(parentId: Identifier, id: Identifier): Promise<Phase>;
6341
+ get(parentId: Identifier, id: Identifier, opts?: {
6342
+ fresh?: boolean;
6343
+ } | null): Promise<Phase>;
6174
6344
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6175
6345
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6176
6346
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6209,8 +6379,10 @@ declare class ProductsResource extends BaseResource<Product, ProductCreate, Prod
6209
6379
  queryAll(params?: ProductsResourceQueryParams): Promise<Product[]>;
6210
6380
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6211
6381
  count(params?: ProductsResourceQueryParams): Promise<number>;
6212
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6213
- get(id: Identifier): Promise<Product>;
6382
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6383
+ get(id: Identifier, opts?: {
6384
+ fresh?: boolean;
6385
+ } | null): Promise<Product>;
6214
6386
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6215
6387
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6216
6388
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6261,7 +6433,9 @@ declare class ProductVendorsResource extends BaseResource<ProductVendors, Produc
6261
6433
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6262
6434
  count(params?: ProductVendorsResourceQueryParams): Promise<number>;
6263
6435
  /** Get one record by parent + id (/V1.0/Products/{parentId}/Vendors/{id} — vendor item envelope; item: null → NotFoundError). */
6264
- get(parentId: Identifier, id: Identifier): Promise<ProductVendors>;
6436
+ get(parentId: Identifier, id: Identifier, opts?: {
6437
+ fresh?: boolean;
6438
+ } | null): Promise<ProductVendors>;
6265
6439
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6266
6440
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6267
6441
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6303,7 +6477,9 @@ declare class ProjectChargesResource extends BaseResource<ProjectCharge, Project
6303
6477
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6304
6478
  count(params?: ProjectChargesResourceQueryParams): Promise<number>;
6305
6479
  /** Get one record by parent + id (/V1.0/Projects/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
6306
- get(parentId: Identifier, id: Identifier): Promise<ProjectCharge>;
6480
+ get(parentId: Identifier, id: Identifier, opts?: {
6481
+ fresh?: boolean;
6482
+ } | null): Promise<ProjectCharge>;
6307
6483
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6308
6484
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6309
6485
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6352,7 +6528,9 @@ declare class ProjectNotesResource extends BaseResource<ProjectNote, ProjectNote
6352
6528
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6353
6529
  count(params?: ProjectNotesResourceQueryParams): Promise<number>;
6354
6530
  /** Get one record by parent + id (/V1.0/Projects/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
6355
- get(parentId: Identifier, id: Identifier): Promise<ProjectNote>;
6531
+ get(parentId: Identifier, id: Identifier, opts?: {
6532
+ fresh?: boolean;
6533
+ } | null): Promise<ProjectNote>;
6356
6534
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6357
6535
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6358
6536
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6391,8 +6569,10 @@ declare class ProjectsResource extends BaseResource<Project, ProjectCreate, Proj
6391
6569
  queryAll(params?: ProjectsResourceQueryParams): Promise<Project[]>;
6392
6570
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6393
6571
  count(params?: ProjectsResourceQueryParams): Promise<number>;
6394
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6395
- get(id: Identifier): Promise<Project>;
6572
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6573
+ get(id: Identifier, opts?: {
6574
+ fresh?: boolean;
6575
+ } | null): Promise<Project>;
6396
6576
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6397
6577
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6398
6578
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6446,8 +6626,10 @@ declare class PurchaseApprovalsResource extends BaseResource<PurchaseApprovals,
6446
6626
  queryAll(params?: PurchaseApprovalsResourceQueryParams): Promise<PurchaseApprovals[]>;
6447
6627
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6448
6628
  count(params?: PurchaseApprovalsResourceQueryParams): Promise<number>;
6449
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6450
- get(id: Identifier): Promise<PurchaseApprovals>;
6629
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6630
+ get(id: Identifier, opts?: {
6631
+ fresh?: boolean;
6632
+ } | null): Promise<PurchaseApprovals>;
6451
6633
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
6452
6634
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
6453
6635
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -6489,7 +6671,9 @@ declare class PurchaseOrderItemReceivingResource extends BaseResource<PurchaseOr
6489
6671
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6490
6672
  count(params?: PurchaseOrderItemReceivingResourceQueryParams): Promise<number>;
6491
6673
  /** Get one record by parent + id (/V1.0/PurchaseOrderItems/{parentId}/Receiving/{id} — vendor item envelope; item: null → NotFoundError). */
6492
- get(parentId: Identifier, id: Identifier): Promise<PurchaseOrderItemReceiving>;
6674
+ get(parentId: Identifier, id: Identifier, opts?: {
6675
+ fresh?: boolean;
6676
+ } | null): Promise<PurchaseOrderItemReceiving>;
6493
6677
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6494
6678
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6495
6679
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6526,7 +6710,9 @@ declare class PurchaseOrderItemsResource extends BaseResource<PurchaseOrderItems
6526
6710
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6527
6711
  count(params?: PurchaseOrderItemsResourceQueryParams): Promise<number>;
6528
6712
  /** Get one record by parent + id (/V1.0/PurchaseOrders/{parentId}/Items/{id} — vendor item envelope; item: null → NotFoundError). */
6529
- get(parentId: Identifier, id: Identifier): Promise<PurchaseOrderItems>;
6713
+ get(parentId: Identifier, id: Identifier, opts?: {
6714
+ fresh?: boolean;
6715
+ } | null): Promise<PurchaseOrderItems>;
6530
6716
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6531
6717
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6532
6718
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6565,8 +6751,10 @@ declare class PurchaseOrdersResource extends BaseResource<PurchaseOrders, Purcha
6565
6751
  queryAll(params?: PurchaseOrdersResourceQueryParams): Promise<PurchaseOrders[]>;
6566
6752
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6567
6753
  count(params?: PurchaseOrdersResourceQueryParams): Promise<number>;
6568
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6569
- get(id: Identifier): Promise<PurchaseOrders>;
6754
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6755
+ get(id: Identifier, opts?: {
6756
+ fresh?: boolean;
6757
+ } | null): Promise<PurchaseOrders>;
6570
6758
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6571
6759
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6572
6760
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6613,7 +6801,9 @@ declare class QuoteItemsResource extends BaseResource<QuoteItem, QuoteItemCreate
6613
6801
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6614
6802
  count(params?: QuoteItemsResourceQueryParams): Promise<number>;
6615
6803
  /** Get one record by parent + id (/V1.0/Quotes/{parentId}/Items/{id} — vendor item envelope; item: null → NotFoundError). */
6616
- get(parentId: Identifier, id: Identifier): Promise<QuoteItem>;
6804
+ get(parentId: Identifier, id: Identifier, opts?: {
6805
+ fresh?: boolean;
6806
+ } | null): Promise<QuoteItem>;
6617
6807
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6618
6808
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6619
6809
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6661,8 +6851,10 @@ declare class QuoteLocationsResource extends BaseResource<QuoteLocation, QuoteLo
6661
6851
  queryAll(params?: QuoteLocationsResourceQueryParams): Promise<QuoteLocation[]>;
6662
6852
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6663
6853
  count(params?: QuoteLocationsResourceQueryParams): Promise<number>;
6664
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6665
- get(id: Identifier): Promise<QuoteLocation>;
6854
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6855
+ get(id: Identifier, opts?: {
6856
+ fresh?: boolean;
6857
+ } | null): Promise<QuoteLocation>;
6666
6858
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6667
6859
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6668
6860
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6706,8 +6898,10 @@ declare class QuotesResource extends BaseResource<Quote, QuoteCreate, QuoteUpdat
6706
6898
  queryAll(params?: QuotesResourceQueryParams): Promise<Quote[]>;
6707
6899
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6708
6900
  count(params?: QuotesResourceQueryParams): Promise<number>;
6709
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6710
- get(id: Identifier): Promise<Quote>;
6901
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6902
+ get(id: Identifier, opts?: {
6903
+ fresh?: boolean;
6904
+ } | null): Promise<Quote>;
6711
6905
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6712
6906
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6713
6907
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6755,8 +6949,10 @@ declare class QuoteTemplatesResource extends BaseResource<QuoteTemplate, QuoteTe
6755
6949
  queryAll(params?: QuoteTemplatesResourceQueryParams): Promise<QuoteTemplate[]>;
6756
6950
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6757
6951
  count(params?: QuoteTemplatesResourceQueryParams): Promise<number>;
6758
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6759
- get(id: Identifier): Promise<QuoteTemplate>;
6952
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6953
+ get(id: Identifier, opts?: {
6954
+ fresh?: boolean;
6955
+ } | null): Promise<QuoteTemplate>;
6760
6956
  /** Resolve a QuoteTemplate from a numeric id (or, where the vendor indexes a primary text field,
6761
6957
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
6762
6958
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -6792,7 +6988,9 @@ declare class ResourceRoleQueuesResource extends BaseResource<ResourceRoleQueue,
6792
6988
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6793
6989
  count(params?: ResourceRoleQueuesResourceQueryParams): Promise<number>;
6794
6990
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/RoleQueues/{id} — vendor item envelope; item: null → NotFoundError). */
6795
- get(parentId: Identifier, id: Identifier): Promise<ResourceRoleQueue>;
6991
+ get(parentId: Identifier, id: Identifier, opts?: {
6992
+ fresh?: boolean;
6993
+ } | null): Promise<ResourceRoleQueue>;
6796
6994
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6797
6995
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6798
6996
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6834,7 +7032,9 @@ declare class ResourceRolesResource extends BaseResource<ResourceRole, ResourceR
6834
7032
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6835
7033
  count(params?: ResourceRolesResourceQueryParams): Promise<number>;
6836
7034
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/Roles/{id} — vendor item envelope; item: null → NotFoundError). */
6837
- get(parentId: Identifier, id: Identifier): Promise<ResourceRole>;
7035
+ get(parentId: Identifier, id: Identifier, opts?: {
7036
+ fresh?: boolean;
7037
+ } | null): Promise<ResourceRole>;
6838
7038
  /** Resolve a ResourceRole from a numeric id (or, where the vendor indexes a primary text field,
6839
7039
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
6840
7040
  * a bare value rejects with a config error (ids only);
@@ -6866,7 +7066,9 @@ declare class ResourceSkillsResource extends BaseResource<ResourceSkill, Resourc
6866
7066
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6867
7067
  count(params?: ResourceSkillsResourceQueryParams): Promise<number>;
6868
7068
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/Skills/{id} — vendor item envelope; item: null → NotFoundError). */
6869
- get(parentId: Identifier, id: Identifier): Promise<ResourceSkill>;
7069
+ get(parentId: Identifier, id: Identifier, opts?: {
7070
+ fresh?: boolean;
7071
+ } | null): Promise<ResourceSkill>;
6870
7072
  /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
6871
7073
  * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
6872
7074
  * the pinned envelope with the best-effort diff; a caller-supplied lastModifiedDate that
@@ -6935,13 +7137,10 @@ declare class ResourcesResource extends BaseResource<Resource, ResourceCreate, R
6935
7137
  queryAll(params?: ResourcesResourceQueryParams): Promise<Resource[]>;
6936
7138
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6937
7139
  count(params?: ResourcesResourceQueryParams): Promise<number>;
6938
- /** Get one record by id (item envelope; item: null → NotFoundError).
6939
- * `fresh: true` in the opts bag bypasses AND refreshes the ReadCache entry for this id
6940
- * (the per-id authority read of operations.expandResourceNames with fresh: true — issue #77);
6941
- * a plain get is the bit-for-bit cached read. */
7140
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6942
7141
  get(id: Identifier, opts?: {
6943
7142
  fresh?: boolean;
6944
- }): Promise<Resource>;
7143
+ } | null): Promise<Resource>;
6945
7144
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
6946
7145
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
6947
7146
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -7022,7 +7221,9 @@ declare class ResourceTimeOffApproversResource extends BaseResource<ResourceTime
7022
7221
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7023
7222
  count(params?: ResourceTimeOffApproversResourceQueryParams): Promise<number>;
7024
7223
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/TimeOffApprovers/{id} — vendor item envelope; item: null → NotFoundError). */
7025
- get(parentId: Identifier, id: Identifier): Promise<ResourceTimeOffApprover>;
7224
+ get(parentId: Identifier, id: Identifier, opts?: {
7225
+ fresh?: boolean;
7226
+ } | null): Promise<ResourceTimeOffApprover>;
7026
7227
  /** Resolve a ResourceTimeOffApprover from a numeric id (or, where the vendor indexes a primary text field,
7027
7228
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7028
7229
  * a bare value rejects with a config error (ids only);
@@ -7048,7 +7249,9 @@ type ResourceTimeOffBalancesResourceQueryParams = QueryParams;
7048
7249
  declare class ResourceTimeOffBalancesResource extends BaseResource<ResourceTimeOffBalance, ResourceTimeOffBalanceCreate, ResourceTimeOffBalanceUpdate> {
7049
7250
  constructor(http: HttpClient, pageSize: number);
7050
7251
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/TimeOffBalances/{id} — vendor item envelope; item: null → NotFoundError). */
7051
- get(parentId: Identifier, id: Identifier): Promise<ResourceTimeOffBalance>;
7252
+ get(parentId: Identifier, id: Identifier, opts?: {
7253
+ fresh?: boolean;
7254
+ } | null): Promise<ResourceTimeOffBalance>;
7052
7255
  /** Resolve a ResourceTimeOffBalance from a numeric id (or, where the vendor indexes a primary text field,
7053
7256
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7054
7257
  * a bare value rejects with a config error (ids only);
@@ -7081,8 +7284,10 @@ declare class RolesResource extends BaseResource<Role, RoleCreate, RoleUpdate> {
7081
7284
  queryAll(params?: RolesResourceQueryParams): Promise<Role[]>;
7082
7285
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7083
7286
  count(params?: RolesResourceQueryParams): Promise<number>;
7084
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7085
- get(id: Identifier): Promise<Role>;
7287
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7288
+ get(id: Identifier, opts?: {
7289
+ fresh?: boolean;
7290
+ } | null): Promise<Role>;
7086
7291
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7087
7292
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7088
7293
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7130,8 +7335,10 @@ declare class SalesOrdersResource extends BaseResource<SalesOrder, SalesOrderCre
7130
7335
  queryAll(params?: SalesOrdersResourceQueryParams): Promise<SalesOrder[]>;
7131
7336
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7132
7337
  count(params?: SalesOrdersResourceQueryParams): Promise<number>;
7133
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7134
- get(id: Identifier): Promise<SalesOrder>;
7338
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7339
+ get(id: Identifier, opts?: {
7340
+ fresh?: boolean;
7341
+ } | null): Promise<SalesOrder>;
7135
7342
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
7136
7343
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
7137
7344
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -7160,8 +7367,10 @@ declare class ServiceCallsResource extends BaseResource<ServiceCall, ServiceCall
7160
7367
  queryAll(params?: ServiceCallsResourceQueryParams): Promise<ServiceCall[]>;
7161
7368
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7162
7369
  count(params?: ServiceCallsResourceQueryParams): Promise<number>;
7163
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7164
- get(id: Identifier): Promise<ServiceCall>;
7370
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7371
+ get(id: Identifier, opts?: {
7372
+ fresh?: boolean;
7373
+ } | null): Promise<ServiceCall>;
7165
7374
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7166
7375
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7167
7376
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7211,7 +7420,9 @@ declare class ServiceCallTaskResourcesResource extends BaseResource<ServiceCallT
7211
7420
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7212
7421
  count(params?: ServiceCallTaskResourcesResourceQueryParams): Promise<number>;
7213
7422
  /** Get one record by parent + id (/V1.0/ServiceCallTasks/{parentId}/Resources/{id} — vendor item envelope; item: null → NotFoundError). */
7214
- get(parentId: Identifier, id: Identifier): Promise<ServiceCallTaskResource>;
7423
+ get(parentId: Identifier, id: Identifier, opts?: {
7424
+ fresh?: boolean;
7425
+ } | null): Promise<ServiceCallTaskResource>;
7215
7426
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7216
7427
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7217
7428
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7251,7 +7462,9 @@ declare class ServiceCallTasksResource extends BaseResource<ServiceCallTask, Ser
7251
7462
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7252
7463
  count(params?: ServiceCallTasksResourceQueryParams): Promise<number>;
7253
7464
  /** Get one record by parent + id (/V1.0/ServiceCalls/{parentId}/Tasks/{id} — vendor item envelope; item: null → NotFoundError). */
7254
- get(parentId: Identifier, id: Identifier): Promise<ServiceCallTask>;
7465
+ get(parentId: Identifier, id: Identifier, opts?: {
7466
+ fresh?: boolean;
7467
+ } | null): Promise<ServiceCallTask>;
7255
7468
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7256
7469
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7257
7470
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7291,7 +7504,9 @@ declare class ServiceCallTicketResourcesResource extends BaseResource<ServiceCal
7291
7504
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7292
7505
  count(params?: ServiceCallTicketResourcesResourceQueryParams): Promise<number>;
7293
7506
  /** Get one record by parent + id (/V1.0/ServiceCallTickets/{parentId}/Resources/{id} — vendor item envelope; item: null → NotFoundError). */
7294
- get(parentId: Identifier, id: Identifier): Promise<ServiceCallTicketResource>;
7507
+ get(parentId: Identifier, id: Identifier, opts?: {
7508
+ fresh?: boolean;
7509
+ } | null): Promise<ServiceCallTicketResource>;
7295
7510
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7296
7511
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7297
7512
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7331,7 +7546,9 @@ declare class ServiceCallTicketsResource extends BaseResource<ServiceCallTicket,
7331
7546
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7332
7547
  count(params?: ServiceCallTicketsResourceQueryParams): Promise<number>;
7333
7548
  /** Get one record by parent + id (/V1.0/ServiceCalls/{parentId}/Tickets/{id} — vendor item envelope; item: null → NotFoundError). */
7334
- get(parentId: Identifier, id: Identifier): Promise<ServiceCallTicket>;
7549
+ get(parentId: Identifier, id: Identifier, opts?: {
7550
+ fresh?: boolean;
7551
+ } | null): Promise<ServiceCallTicket>;
7335
7552
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7336
7553
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7337
7554
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7368,8 +7585,10 @@ declare class ServiceLevelAgreementResultsResource extends BaseResource<ServiceL
7368
7585
  queryAll(params?: ServiceLevelAgreementResultsResourceQueryParams): Promise<ServiceLevelAgreementResults[]>;
7369
7586
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7370
7587
  count(params?: ServiceLevelAgreementResultsResourceQueryParams): Promise<number>;
7371
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7372
- get(id: Identifier): Promise<ServiceLevelAgreementResults>;
7588
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7589
+ get(id: Identifier, opts?: {
7590
+ fresh?: boolean;
7591
+ } | null): Promise<ServiceLevelAgreementResults>;
7373
7592
  /** Resolve a ServiceLevelAgreementResults from a numeric id (or, where the vendor indexes a primary text field,
7374
7593
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7375
7594
  * a bare value rejects with a config error (ids only);
@@ -7398,8 +7617,10 @@ declare class ServicesResource extends BaseResource<Service, ServiceCreate, Serv
7398
7617
  queryAll(params?: ServicesResourceQueryParams): Promise<Service[]>;
7399
7618
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7400
7619
  count(params?: ServicesResourceQueryParams): Promise<number>;
7401
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7402
- get(id: Identifier): Promise<Service>;
7620
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7621
+ get(id: Identifier, opts?: {
7622
+ fresh?: boolean;
7623
+ } | null): Promise<Service>;
7403
7624
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7404
7625
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7405
7626
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7447,8 +7668,10 @@ declare class SkillsResource extends BaseResource<Skill, SkillCreate, SkillUpdat
7447
7668
  queryAll(params?: SkillsResourceQueryParams): Promise<Skill[]>;
7448
7669
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7449
7670
  count(params?: SkillsResourceQueryParams): Promise<number>;
7450
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7451
- get(id: Identifier): Promise<Skill>;
7671
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7672
+ get(id: Identifier, opts?: {
7673
+ fresh?: boolean;
7674
+ } | null): Promise<Skill>;
7452
7675
  /** Resolve a Skill from a numeric id (or, where the vendor indexes a primary text field,
7453
7676
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
7454
7677
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -7481,8 +7704,10 @@ declare class SubscriptionPeriodsResource extends BaseResource<SubscriptionPerio
7481
7704
  queryAll(params?: SubscriptionPeriodsResourceQueryParams): Promise<SubscriptionPeriod[]>;
7482
7705
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7483
7706
  count(params?: SubscriptionPeriodsResourceQueryParams): Promise<number>;
7484
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7485
- get(id: Identifier): Promise<SubscriptionPeriod>;
7707
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7708
+ get(id: Identifier, opts?: {
7709
+ fresh?: boolean;
7710
+ } | null): Promise<SubscriptionPeriod>;
7486
7711
  /** Resolve a SubscriptionPeriod from a numeric id (or, where the vendor indexes a primary text field,
7487
7712
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7488
7713
  * a bare value rejects with a config error (ids only);
@@ -7511,8 +7736,10 @@ declare class SubscriptionsResource extends BaseResource<Subscription, Subscript
7511
7736
  queryAll(params?: SubscriptionsResourceQueryParams): Promise<Subscription[]>;
7512
7737
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7513
7738
  count(params?: SubscriptionsResourceQueryParams): Promise<number>;
7514
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7515
- get(id: Identifier): Promise<Subscription>;
7739
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7740
+ get(id: Identifier, opts?: {
7741
+ fresh?: boolean;
7742
+ } | null): Promise<Subscription>;
7516
7743
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7517
7744
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7518
7745
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7559,8 +7786,10 @@ declare class SurveyResultsResource extends BaseResource<SurveyResults, SurveyRe
7559
7786
  queryAll(params?: SurveyResultsResourceQueryParams): Promise<SurveyResults[]>;
7560
7787
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7561
7788
  count(params?: SurveyResultsResourceQueryParams): Promise<number>;
7562
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7563
- get(id: Identifier): Promise<SurveyResults>;
7789
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7790
+ get(id: Identifier, opts?: {
7791
+ fresh?: boolean;
7792
+ } | null): Promise<SurveyResults>;
7564
7793
  /** Resolve a SurveyResults from a numeric id (or, where the vendor indexes a primary text field,
7565
7794
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7566
7795
  * a bare value rejects with a config error (ids only);
@@ -7589,8 +7818,10 @@ declare class SurveysResource extends BaseResource<Survey, SurveyCreate, SurveyU
7589
7818
  queryAll(params?: SurveysResourceQueryParams): Promise<Survey[]>;
7590
7819
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7591
7820
  count(params?: SurveysResourceQueryParams): Promise<number>;
7592
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7593
- get(id: Identifier): Promise<Survey>;
7821
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7822
+ get(id: Identifier, opts?: {
7823
+ fresh?: boolean;
7824
+ } | null): Promise<Survey>;
7594
7825
  /** Resolve a Survey from a numeric id (or, where the vendor indexes a primary text field,
7595
7826
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
7596
7827
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -7626,7 +7857,9 @@ declare class TagAliasesResource extends BaseResource<TagAlias, TagAliasCreate,
7626
7857
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7627
7858
  count(params?: TagAliasesResourceQueryParams): Promise<number>;
7628
7859
  /** Get one record by parent + id (/V1.0/Tags/{parentId}/Aliases/{id} — vendor item envelope; item: null → NotFoundError). */
7629
- get(parentId: Identifier, id: Identifier): Promise<TagAlias>;
7860
+ get(parentId: Identifier, id: Identifier, opts?: {
7861
+ fresh?: boolean;
7862
+ } | null): Promise<TagAlias>;
7630
7863
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7631
7864
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7632
7865
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7663,8 +7896,10 @@ declare class TagGroupsResource extends BaseResource<TagGroup, TagGroupCreate, T
7663
7896
  queryAll(params?: TagGroupsResourceQueryParams): Promise<TagGroup[]>;
7664
7897
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7665
7898
  count(params?: TagGroupsResourceQueryParams): Promise<number>;
7666
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7667
- get(id: Identifier): Promise<TagGroup>;
7899
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7900
+ get(id: Identifier, opts?: {
7901
+ fresh?: boolean;
7902
+ } | null): Promise<TagGroup>;
7668
7903
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7669
7904
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7670
7905
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7711,8 +7946,10 @@ declare class TagsResource extends BaseResource<Tag, TagCreate, TagUpdate> {
7711
7946
  queryAll(params?: TagsResourceQueryParams): Promise<Tag[]>;
7712
7947
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7713
7948
  count(params?: TagsResourceQueryParams): Promise<number>;
7714
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7715
- get(id: Identifier): Promise<Tag>;
7949
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7950
+ get(id: Identifier, opts?: {
7951
+ fresh?: boolean;
7952
+ } | null): Promise<Tag>;
7716
7953
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7717
7954
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7718
7955
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7762,7 +7999,9 @@ declare class TaskSecondaryResourcesResource extends BaseResource<TaskSecondaryR
7762
7999
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7763
8000
  count(params?: TaskSecondaryResourcesResourceQueryParams): Promise<number>;
7764
8001
  /** Get one record by parent + id (/V1.0/Tasks/{parentId}/SecondaryResources/{id} — vendor item envelope; item: null → NotFoundError). */
7765
- get(parentId: Identifier, id: Identifier): Promise<TaskSecondaryResource>;
8002
+ get(parentId: Identifier, id: Identifier, opts?: {
8003
+ fresh?: boolean;
8004
+ } | null): Promise<TaskSecondaryResource>;
7766
8005
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7767
8006
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7768
8007
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7802,7 +8041,9 @@ declare class TasksResource extends BaseResource<Task, TaskCreate, TaskUpdate> {
7802
8041
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7803
8042
  count(params?: TasksResourceQueryParams): Promise<number>;
7804
8043
  /** Get one record by parent + id (/V1.0/Projects/{parentId}/Tasks/{id} — vendor item envelope; item: null → NotFoundError). */
7805
- get(parentId: Identifier, id: Identifier): Promise<Task>;
8044
+ get(parentId: Identifier, id: Identifier, opts?: {
8045
+ fresh?: boolean;
8046
+ } | null): Promise<Task>;
7806
8047
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7807
8048
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7808
8049
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7845,8 +8086,10 @@ declare class TaxRegionsResource extends BaseResource<TaxRegion, TaxRegionCreate
7845
8086
  queryAll(params?: TaxRegionsResourceQueryParams): Promise<TaxRegion[]>;
7846
8087
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7847
8088
  count(params?: TaxRegionsResourceQueryParams): Promise<number>;
7848
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7849
- get(id: Identifier): Promise<TaxRegion>;
8089
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
8090
+ get(id: Identifier, opts?: {
8091
+ fresh?: boolean;
8092
+ } | null): Promise<TaxRegion>;
7850
8093
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7851
8094
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7852
8095
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7898,7 +8141,9 @@ declare class TicketAdditionalConfigurationItemsResource extends BaseResource<Ti
7898
8141
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7899
8142
  count(params?: TicketAdditionalConfigurationItemsResourceQueryParams): Promise<number>;
7900
8143
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/AdditionalConfigurationItems/{id} — vendor item envelope; item: null → NotFoundError). */
7901
- get(parentId: Identifier, id: Identifier): Promise<TicketAdditionalConfigurationItem>;
8144
+ get(parentId: Identifier, id: Identifier, opts?: {
8145
+ fresh?: boolean;
8146
+ } | null): Promise<TicketAdditionalConfigurationItem>;
7902
8147
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7903
8148
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7904
8149
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7938,7 +8183,9 @@ declare class TicketAdditionalContactsResource extends BaseResource<TicketAdditi
7938
8183
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7939
8184
  count(params?: TicketAdditionalContactsResourceQueryParams): Promise<number>;
7940
8185
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/AdditionalContacts/{id} — vendor item envelope; item: null → NotFoundError). */
7941
- get(parentId: Identifier, id: Identifier): Promise<TicketAdditionalContact>;
8186
+ get(parentId: Identifier, id: Identifier, opts?: {
8187
+ fresh?: boolean;
8188
+ } | null): Promise<TicketAdditionalContact>;
7942
8189
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7943
8190
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7944
8191
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7978,7 +8225,9 @@ declare class TicketAttachmentsResource extends BaseResource<TicketAttachment, T
7978
8225
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7979
8226
  count(params?: TicketAttachmentsResourceQueryParams): Promise<number>;
7980
8227
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Attachments/{id} — vendor answers the model directly). */
7981
- get(parentId: Identifier, id: Identifier): Promise<TicketAttachment>;
8228
+ get(parentId: Identifier, id: Identifier, opts?: {
8229
+ fresh?: boolean;
8230
+ } | null): Promise<TicketAttachment>;
7982
8231
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7983
8232
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7984
8233
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8017,8 +8266,10 @@ declare class TicketCategoriesResource extends BaseResource<TicketCategory, Tick
8017
8266
  queryAll(params?: TicketCategoriesResourceQueryParams): Promise<TicketCategory[]>;
8018
8267
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8019
8268
  count(params?: TicketCategoriesResourceQueryParams): Promise<number>;
8020
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8021
- get(id: Identifier): Promise<TicketCategory>;
8269
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
8270
+ get(id: Identifier, opts?: {
8271
+ fresh?: boolean;
8272
+ } | null): Promise<TicketCategory>;
8022
8273
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
8023
8274
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
8024
8275
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -8064,7 +8315,9 @@ declare class TicketCategoryFieldDefaultsResource extends BaseResource<TicketCat
8064
8315
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8065
8316
  count(params?: TicketCategoryFieldDefaultsResourceQueryParams): Promise<number>;
8066
8317
  /** Get one record by parent + id (/V1.0/TicketCategories/{parentId}/FieldDefaults/{id} — vendor item envelope; item: null → NotFoundError). */
8067
- get(parentId: Identifier, id: Identifier): Promise<TicketCategoryFieldDefault>;
8318
+ get(parentId: Identifier, id: Identifier, opts?: {
8319
+ fresh?: boolean;
8320
+ } | null): Promise<TicketCategoryFieldDefault>;
8068
8321
  /** Resolve a TicketCategoryFieldDefault from a numeric id (or, where the vendor indexes a primary text field,
8069
8322
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
8070
8323
  * a bare value rejects with a config error (ids only);
@@ -8096,7 +8349,9 @@ declare class TicketChangeRequestApprovalsResource extends BaseResource<TicketCh
8096
8349
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8097
8350
  count(params?: TicketChangeRequestApprovalsResourceQueryParams): Promise<number>;
8098
8351
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/ChangeRequestApprovals/{id} — vendor item envelope; item: null → NotFoundError). */
8099
- get(parentId: Identifier, id: Identifier): Promise<TicketChangeRequestApproval>;
8352
+ get(parentId: Identifier, id: Identifier, opts?: {
8353
+ fresh?: boolean;
8354
+ } | null): Promise<TicketChangeRequestApproval>;
8100
8355
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8101
8356
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8102
8357
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8199,7 +8454,9 @@ declare class TicketChargesResource extends BaseResource<TicketCharge, TicketCha
8199
8454
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8200
8455
  count(params?: TicketChargesResourceQueryParams): Promise<number>;
8201
8456
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
8202
- get(parentId: Identifier, id: Identifier): Promise<TicketCharge>;
8457
+ get(parentId: Identifier, id: Identifier, opts?: {
8458
+ fresh?: boolean;
8459
+ } | null): Promise<TicketCharge>;
8203
8460
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8204
8461
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8205
8462
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8250,7 +8507,9 @@ declare class TicketChecklistItemsResource extends BaseResource<TicketChecklistI
8250
8507
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8251
8508
  count(params?: TicketChecklistItemsResourceQueryParams): Promise<number>;
8252
8509
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/ChecklistItems/{id} — vendor item envelope; item: null → NotFoundError). */
8253
- get(parentId: Identifier, id: Identifier): Promise<TicketChecklistItem>;
8510
+ get(parentId: Identifier, id: Identifier, opts?: {
8511
+ fresh?: boolean;
8512
+ } | null): Promise<TicketChecklistItem>;
8254
8513
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8255
8514
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8256
8515
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8325,8 +8584,10 @@ declare class TicketHistoryResource extends BaseResource<TicketHistory, TicketHi
8325
8584
  queryAll(params?: TicketHistoryResourceQueryParams): Promise<TicketHistory[]>;
8326
8585
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8327
8586
  count(params?: TicketHistoryResourceQueryParams): Promise<number>;
8328
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8329
- get(id: Identifier): Promise<TicketHistory>;
8587
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
8588
+ get(id: Identifier, opts?: {
8589
+ fresh?: boolean;
8590
+ } | null): Promise<TicketHistory>;
8330
8591
  /** Resolve a TicketHistory from a numeric id (or, where the vendor indexes a primary text field,
8331
8592
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
8332
8593
  * a bare value rejects with a config error (ids only);
@@ -8358,7 +8619,9 @@ declare class TicketNoteAttachmentsResource extends BaseResource<TicketNoteAttac
8358
8619
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8359
8620
  count(params?: TicketNoteAttachmentsResourceQueryParams): Promise<number>;
8360
8621
  /** Get one record by parent + id (/V1.0/TicketNotes/{parentId}/Attachments/{id} — vendor answers the model directly). */
8361
- get(parentId: Identifier, id: Identifier): Promise<TicketNoteAttachment>;
8622
+ get(parentId: Identifier, id: Identifier, opts?: {
8623
+ fresh?: boolean;
8624
+ } | null): Promise<TicketNoteAttachment>;
8362
8625
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8363
8626
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8364
8627
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8400,7 +8663,9 @@ declare class TicketNotesResource extends BaseResource<TicketNote, TicketNoteCre
8400
8663
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8401
8664
  count(params?: TicketNotesResourceQueryParams): Promise<number>;
8402
8665
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
8403
- get(parentId: Identifier, id: Identifier): Promise<TicketNote>;
8666
+ get(parentId: Identifier, id: Identifier, opts?: {
8667
+ fresh?: boolean;
8668
+ } | null): Promise<TicketNote>;
8404
8669
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8405
8670
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8406
8671
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8441,8 +8706,10 @@ declare class TicketNoteWebhooksResource extends BaseResource<TicketNoteWebhook,
8441
8706
  queryAll(params?: TicketNoteWebhooksResourceQueryParams): Promise<TicketNoteWebhook[]>;
8442
8707
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8443
8708
  count(params?: TicketNoteWebhooksResourceQueryParams): Promise<number>;
8444
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8445
- get(id: Identifier): Promise<TicketNoteWebhook>;
8709
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
8710
+ get(id: Identifier, opts?: {
8711
+ fresh?: boolean;
8712
+ } | null): Promise<TicketNoteWebhook>;
8446
8713
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
8447
8714
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8448
8715
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8496,7 +8763,9 @@ declare class TicketSecondaryResourcesResource extends BaseResource<TicketSecond
8496
8763
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8497
8764
  count(params?: TicketSecondaryResourcesResourceQueryParams): Promise<number>;
8498
8765
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/SecondaryResources/{id} — vendor item envelope; item: null → NotFoundError). */
8499
- get(parentId: Identifier, id: Identifier): Promise<TicketSecondaryResource>;
8766
+ get(parentId: Identifier, id: Identifier, opts?: {
8767
+ fresh?: boolean;
8768
+ } | null): Promise<TicketSecondaryResource>;
8500
8769
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8501
8770
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8502
8771
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8795,6 +9064,36 @@ interface TicketsForResourceOptions {
8795
9064
  limit?: number;
8796
9065
  /** Extra Ticket fields on top of the pinned projection (id, ticketNumber, title, status, assignedResourceID, companyID). */
8797
9066
  includeFields?: string[];
9067
+ /** `false` (default true, unchanged): throw `STATUS_SEMANTICS_UNRESOLVED` instead of falling back to the assumed closed id 5 when the tenant picklist cannot be resolved (issue #244). */
9068
+ allowAssumed?: boolean;
9069
+ /** `true` (issue #248): return only the OPEN-ticket counts (`TicketsForResourceCountResult`, no ticket rows). `openOnly` and `limit` do not apply (`limit` is not validated): the open filter is always on and no rows are returned. The secondary link read follows next-page links (ids only) up to 20 pages, so `capped` is true only past 10,000 links. */
9070
+ countOnly?: boolean;
9071
+ }
9072
+ /** Options that select the rows result (`countOnly` absent or false). */
9073
+ type TicketsForResourceListOptions = Omit<TicketsForResourceOptions, 'countOnly'> & {
9074
+ countOnly?: false;
9075
+ };
9076
+ /** Options that select the count-only result. */
9077
+ type TicketsForResourceCountOptions = Omit<TicketsForResourceOptions, 'countOnly'> & {
9078
+ countOnly: true;
9079
+ };
9080
+ /**
9081
+ * The count-only result (issue #248). All figures count OPEN tickets (the same
9082
+ * filter as `tickets.count` with `status` not in the closed set): `primary`
9083
+ * equals `tickets.count({ filter: [assignedResourceID eq R, open leaf] })`,
9084
+ * `secondary` is the de-duplicated open secondary ticket ids, `both` their
9085
+ * overlap, `open` the union (primary + secondary - both).
9086
+ */
9087
+ interface TicketsForResourceCountResult {
9088
+ resourceID: number;
9089
+ scope: TicketAssignmentScope;
9090
+ primary: number;
9091
+ secondary: number;
9092
+ both: number;
9093
+ open: number;
9094
+ /** True only when the secondary link read had more pages than it read, so `secondary`/`both`/`open` may undercount. */
9095
+ capped: boolean;
9096
+ closedStatus: TicketStatusDisclosure;
8798
9097
  }
8799
9098
  interface TicketsForResourceResult {
8800
9099
  resourceID: number;
@@ -8862,8 +9161,10 @@ declare class TicketsResource extends BaseResource<Ticket, TicketCreate, TicketU
8862
9161
  queryAll(params?: TicketsResourceQueryParams): Promise<Ticket[]>;
8863
9162
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8864
9163
  count(params?: TicketsResourceQueryParams): Promise<number>;
8865
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8866
- get(id: Identifier): Promise<Ticket>;
9164
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
9165
+ get(id: Identifier, opts?: {
9166
+ fresh?: boolean;
9167
+ } | null): Promise<Ticket>;
8867
9168
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
8868
9169
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8869
9170
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8927,7 +9228,9 @@ declare class TicketsResource extends BaseResource<Ticket, TicketCreate, TicketU
8927
9228
  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
8928
9229
  statusSemantics(opts?: TicketStatusOptions): Promise<TicketStatusSemantics>;
8929
9230
  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
8930
- forResource(resourceID: Identifier, opts?: TicketsForResourceOptions): Promise<TicketsForResourceResult>;
9231
+ forResource(resourceID: Identifier, opts?: TicketsForResourceListOptions): Promise<TicketsForResourceResult>;
9232
+ forResource(resourceID: Identifier, opts: TicketsForResourceCountOptions): Promise<TicketsForResourceCountResult>;
9233
+ forResource(resourceID: Identifier, opts?: TicketsForResourceOptions): Promise<TicketsForResourceResult | TicketsForResourceCountResult>;
8931
9234
  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
8932
9235
  lineOfBusiness(ticketId: Identifier, associationId?: Identifier): Promise<TicketLineOfBusinessResult>;
8933
9236
  }
@@ -8950,8 +9253,10 @@ declare class TicketWebhooksResource extends BaseResource<TicketWebhook, TicketW
8950
9253
  queryAll(params?: TicketWebhooksResourceQueryParams): Promise<TicketWebhook[]>;
8951
9254
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8952
9255
  count(params?: TicketWebhooksResourceQueryParams): Promise<number>;
8953
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8954
- get(id: Identifier): Promise<TicketWebhook>;
9256
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
9257
+ get(id: Identifier, opts?: {
9258
+ fresh?: boolean;
9259
+ } | null): Promise<TicketWebhook>;
8955
9260
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
8956
9261
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8957
9262
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8990,7 +9295,21 @@ declare class TicketWebhooksResource extends BaseResource<TicketWebhook, TicketW
8990
9295
  * `limit`, and the `tz` IANA-zone anchor; omitted `tz` = UTC, the current
8991
9296
  * behaviour bit-for-bit) under its historical name. */
8992
9297
  type TimeEntriesWindowOptions = DateWindowOptions;
8993
- interface TimeEntriesStatusOptions {
9298
+ /**
9299
+ * Paging past the 500-entry cap (issue #242), shared by getPosted / getUnposted /
9300
+ * postedWithin / dateWorkedWindow. `cursor` pages a busy window across calls (each
9301
+ * call stays one entry page + at most 2 joins); `countOnly` returns the window's
9302
+ * honest totals in one budgeted call.
9303
+ */
9304
+ interface TimeEntriesPostedPagingOptions {
9305
+ /** Continue the window: the `nextCursor` of the previous call made with the SAME window and filters. The page is the vendor's continuation page (up to 500 entries; `limit` sizes the first page only), joined the same way. Not with `countOnly`. */
9306
+ cursor?: string;
9307
+ /** `true`: return only the window's totals (`TimeEntriesPostedCountResult`, no rows). One count call sizes the window, then EVERY entry page is read (ids only) and joined, under `maxVendorCalls`; complete or a typed refusal, never a short total (the distinct-id total must equal the count before or after the walk, else INVALID_RESPONSE). `limit` and `posted` do not apply. */
9308
+ countOnly?: boolean;
9309
+ /** The countOnly wire budget (integer 1-200, default 30). An estimate (1 count + 1 per 500 entries + 1 per 250 entries + 1 re-count after the walk) over it refuses with BUDGET_EXCEEDED before any page is read. */
9310
+ maxVendorCalls?: number;
9311
+ }
9312
+ interface TimeEntriesStatusOptions extends TimeEntriesPostedPagingOptions {
8994
9313
  /** Max entries read (default 500 = the hard cap, issue #128); `hasMore` flags a capped read. */
8995
9314
  limit?: number;
8996
9315
  /** Optional ticketID eq narrowing (node parity). */
@@ -9013,13 +9332,45 @@ interface TimeEntriesPostedStateResult {
9013
9332
  from: string | null;
9014
9333
  to: string | null;
9015
9334
  };
9335
+ /** The vendor's next-page cursor for the entry read: pass it back as `opts.cursor` (same window and filters) to read the next page. null on the last page. */
9336
+ nextCursor: string | null;
9337
+ /** Entries read on this page whose billing-item join page was truncated: withheld from `items` (never called posted or unposted), so a cursor loop does not see them. 0 normally; > 0 also sets `hasMore`. */
9338
+ unconfirmed: number;
9016
9339
  /** INFORMATIONAL only, not posted state: items whose `billingApprovalDateTime` is set. Some tenants (ww29) never populate it. */
9017
9340
  approvedCount: number;
9018
9341
  /** INFORMATIONAL only, not posted state: items without `billingApprovalDateTime`. */
9019
9342
  unapprovedCount: number;
9020
9343
  }
9344
+ /** Options that select the rows result (`countOnly` absent or false). */
9345
+ type TimeEntriesStatusListOptions = Omit<TimeEntriesStatusOptions, 'countOnly'> & {
9346
+ countOnly?: false;
9347
+ };
9348
+ /** Options that select the count-only result. */
9349
+ type TimeEntriesStatusCountOptions = Omit<TimeEntriesStatusOptions, 'countOnly'> & {
9350
+ countOnly: true;
9351
+ };
9352
+ /** The countOnly result (issue #242): the whole window, every entry page read and joined. */
9353
+ interface TimeEntriesPostedCountResult {
9354
+ /** The inclusive dateWorked window counted (null side when that bound was not given). */
9355
+ window: {
9356
+ from: string | null;
9357
+ to: string | null;
9358
+ };
9359
+ /** Entries in the window (every page read; de-duplicated by id). Always postedCount + unpostedCount. */
9360
+ total: number;
9361
+ /** Entries a billing item references. */
9362
+ postedCount: number;
9363
+ /** Entries no billing item references. */
9364
+ unpostedCount: number;
9365
+ /** Logical vendor requests this call issued (the count + entry pages + joins); transport retries (429 / 5xx, up to maxRetries each) are not counted. */
9366
+ vendorCalls: number;
9367
+ /** The pre-walk estimate from the count call. */
9368
+ estimate: number;
9369
+ /** The budget in force (`maxVendorCalls`). */
9370
+ budget: number;
9371
+ }
9021
9372
  /** postedWithin options: the optional narrowing + the shared limit bound. */
9022
- interface TimeEntriesPostedWindowOptions {
9373
+ interface TimeEntriesPostedWindowOptions extends TimeEntriesPostedPagingOptions {
9023
9374
  /** Posted narrowing, applied CLIENT-side after the billing-item join: `true` = posted rows only, `false` = unposted rows only (entries no billing item references), omitted = both. No postedDate condition is ever sent. */
9024
9375
  posted?: boolean;
9025
9376
  /** Max records (default 500 = the hard cap — a window with more than 500 matching rows: the bounded query op (time_entries.query) with the same dateWorked filter, its 2500-row walk cap; issue #128). */
@@ -9044,9 +9395,21 @@ interface TimeEntriesPostedWindowResult {
9044
9395
  from: string;
9045
9396
  to: string;
9046
9397
  };
9398
+ /** The vendor's next-page cursor for the entry read: pass it back as `opts.cursor` (same window and filters) to read the next page. null on the last page. */
9399
+ nextCursor: string | null;
9400
+ /** Entries read whose billing-item join page was truncated: in neither count nor a `posted`-narrowed `items` (a cursor loop does not see them). 0 normally; > 0 also sets `truncated`. */
9401
+ unconfirmed: number;
9047
9402
  /** True when the entry read has a live `pageDetails.nextPageUrl` cursor (more matching records than the bounded read returned) OR a billing-item join page was truncated (those entries are in neither count) — the posted/unposted counts then cover the returned rows ONLY (at most `limit`); re-query with a wider window or a narrowing filter to reconcile the totals. */
9048
9403
  truncated: boolean;
9049
9404
  }
9405
+ /** Options that select the rows result (`countOnly` absent or false). */
9406
+ type TimeEntriesPostedWindowListOptions = Omit<TimeEntriesPostedWindowOptions, 'countOnly'> & {
9407
+ countOnly?: false;
9408
+ };
9409
+ /** Options that select the count-only result. */
9410
+ type TimeEntriesPostedWindowCountOptions = Omit<TimeEntriesPostedWindowOptions, 'countOnly'> & {
9411
+ countOnly: true;
9412
+ };
9050
9413
 
9051
9414
  /**
9052
9415
  * `createForResource` params. The typed linkage pins + the time window are
@@ -9213,8 +9576,10 @@ declare class TimeEntriesResource extends BaseResource<TimeEntry, TimeEntryCreat
9213
9576
  queryAll(params?: TimeEntriesResourceQueryParams): Promise<TimeEntry[]>;
9214
9577
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
9215
9578
  count(params?: TimeEntriesResourceQueryParams): Promise<number>;
9216
- /** Get one record by id (item envelope; item: null → NotFoundError). */
9217
- get(id: Identifier): Promise<TimeEntry>;
9579
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
9580
+ get(id: Identifier, opts?: {
9581
+ fresh?: boolean;
9582
+ } | null): Promise<TimeEntry>;
9218
9583
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
9219
9584
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
9220
9585
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -9250,11 +9615,17 @@ declare class TimeEntriesResource extends BaseResource<TimeEntry, TimeEntryCreat
9250
9615
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
9251
9616
  customRange(from: string, to: string, opts?: TimeEntriesWindowOptions): Promise<TimeEntry[]>;
9252
9617
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
9253
- dateWorkedWindow(from: string, to: string, opts?: TimeEntriesPostedWindowOptions): Promise<TimeEntriesPostedWindowResult>;
9618
+ dateWorkedWindow(from: string, to: string, opts?: TimeEntriesPostedWindowListOptions): Promise<TimeEntriesPostedWindowResult>;
9619
+ dateWorkedWindow(from: string, to: string, opts: TimeEntriesPostedWindowCountOptions): Promise<TimeEntriesPostedCountResult>;
9620
+ dateWorkedWindow(from: string, to: string, opts?: TimeEntriesPostedWindowOptions): Promise<TimeEntriesPostedWindowResult | TimeEntriesPostedCountResult>;
9254
9621
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
9255
- getPosted(opts?: TimeEntriesStatusOptions): Promise<TimeEntriesPostedStateResult>;
9622
+ getPosted(opts?: TimeEntriesStatusListOptions): Promise<TimeEntriesPostedStateResult>;
9623
+ getPosted(opts: TimeEntriesStatusCountOptions): Promise<TimeEntriesPostedCountResult>;
9624
+ getPosted(opts?: TimeEntriesStatusOptions): Promise<TimeEntriesPostedStateResult | TimeEntriesPostedCountResult>;
9256
9625
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
9257
- getUnposted(opts?: TimeEntriesStatusOptions): Promise<TimeEntriesPostedStateResult>;
9626
+ getUnposted(opts?: TimeEntriesStatusListOptions): Promise<TimeEntriesPostedStateResult>;
9627
+ getUnposted(opts: TimeEntriesStatusCountOptions): Promise<TimeEntriesPostedCountResult>;
9628
+ getUnposted(opts?: TimeEntriesStatusOptions): Promise<TimeEntriesPostedStateResult | TimeEntriesPostedCountResult>;
9258
9629
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
9259
9630
  last14(opts?: TimeEntriesWindowOptions): Promise<TimeEntry[]>;
9260
9631
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
@@ -9276,7 +9647,9 @@ declare class TimeEntriesResource extends BaseResource<TimeEntry, TimeEntryCreat
9276
9647
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
9277
9648
  moveToTicket(sourceId: Identifier, toTicketId: Identifier, opts?: TimeEntriesMoveToTicketOptions): Promise<TimeEntriesMoveToTicketResult | DryRunResult<Record<string, unknown>>>;
9278
9649
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
9279
- postedWithin(from: string, to: string, opts?: TimeEntriesPostedWindowOptions): Promise<TimeEntriesPostedWindowResult>;
9650
+ postedWithin(from: string, to: string, opts?: TimeEntriesPostedWindowListOptions): Promise<TimeEntriesPostedWindowResult>;
9651
+ postedWithin(from: string, to: string, opts: TimeEntriesPostedWindowCountOptions): Promise<TimeEntriesPostedCountResult>;
9652
+ postedWithin(from: string, to: string, opts?: TimeEntriesPostedWindowOptions): Promise<TimeEntriesPostedWindowResult | TimeEntriesPostedCountResult>;
9280
9653
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
9281
9654
  recentTickets(from: string, to: string, opts: TimeEntriesRecentTicketsOptions): Promise<TimeEntriesRecentTicketsResult>;
9282
9655
  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
@@ -9304,7 +9677,9 @@ declare class TimeEntryAttachmentsResource extends BaseResource<TimeEntryAttachm
9304
9677
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
9305
9678
  count(params?: TimeEntryAttachmentsResourceQueryParams): Promise<number>;
9306
9679
  /** Get one record by parent + id (/V1.0/TimeEntries/{parentId}/Attachments/{id} — vendor answers the model directly). */
9307
- get(parentId: Identifier, id: Identifier): Promise<TimeEntryAttachment>;
9680
+ get(parentId: Identifier, id: Identifier, opts?: {
9681
+ fresh?: boolean;
9682
+ } | null): Promise<TimeEntryAttachment>;
9308
9683
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
9309
9684
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
9310
9685
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -9343,8 +9718,10 @@ declare class TimeOffRequestsResource extends BaseResource<TimeOffRequest, TimeO
9343
9718
  queryAll(params?: TimeOffRequestsResourceQueryParams): Promise<TimeOffRequest[]>;
9344
9719
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
9345
9720
  count(params?: TimeOffRequestsResourceQueryParams): Promise<number>;
9346
- /** Get one record by id (item envelope; item: null → NotFoundError). */
9347
- get(id: Identifier): Promise<TimeOffRequest>;
9721
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
9722
+ get(id: Identifier, opts?: {
9723
+ fresh?: boolean;
9724
+ } | null): Promise<TimeOffRequest>;
9348
9725
  /** Resolve a TimeOffRequest from a numeric id (or, where the vendor indexes a primary text field,
9349
9726
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
9350
9727
  * a bare value rejects with a config error (ids only);
@@ -9623,4 +10000,4 @@ declare class AutotaskClient {
9623
10000
  }): Promise<PromiseSettledResult<R>[]>;
9624
10001
  }
9625
10002
 
9626
- export { type ConfigurationItemDnsRecordsResourceQueryParams as $, type AutotaskConfig as A, BillingCodesResource as B, type CreateIfNotExistsResult as C, type ClassificationIconsResourceQueryParams as D, CompaniesResource as E, type CompaniesResourceQueryParams as F, CompanyAlertsResource as G, type CompanyAlertsResourceQueryParams as H, CompanyLocationsResource as I, type CompanyLocationsResourceQueryParams as J, CompanyNotesResource as K, type CompanyNotesResourceQueryParams as L, CompanySiteConfigurationsResource as M, type CompanySiteConfigurationsResourceQueryParams as N, CompanyWebhooksResource as O, type CompanyWebhooksResourceQueryParams as P, type ConfigProfile as Q, ReadCache as R, ConfigurationItemBillingProductAssociationsResource as S, type TicketChangeStatusResult as T, type ConfigurationItemBillingProductAssociationsResourceQueryParams as U, ConfigurationItemCategoriesResource as V, type ConfigurationItemCategoriesResourceQueryParams as W, ConfigurationItemCategoryUdfAssociationsResource as X, type ConfigurationItemCategoryUdfAssociationsResourceQueryParams as Y, type ZoneName as Z, ConfigurationItemDnsRecordsResource as _, AutotaskClient as a, ContractsResource as a$, ConfigurationItemNotesResource as a0, type ConfigurationItemNotesResourceQueryParams as a1, ConfigurationItemRelatedItemsResource as a2, type ConfigurationItemRelatedItemsResourceQueryParams as a3, ConfigurationItemSslSubjectAlternativeNamesResource as a4, type ConfigurationItemSslSubjectAlternativeNamesResourceQueryParams as a5, ConfigurationItemTypesResource as a6, type ConfigurationItemTypesResourceQueryParams as a7, ConfigurationItemWebhooksResource as a8, type ConfigurationItemWebhooksResourceQueryParams as a9, ContractExclusionSetsResource as aA, type ContractExclusionSetsResourceQueryParams as aB, ContractMilestonesResource as aC, type ContractMilestonesResourceQueryParams as aD, ContractNotesResource as aE, type ContractNotesResourceQueryParams as aF, ContractRatesResource as aG, type ContractRatesResourceQueryParams as aH, ContractRetainersResource as aI, type ContractRetainersResourceQueryParams as aJ, ContractRoleCostsResource as aK, type ContractRoleCostsResourceQueryParams as aL, ContractServiceAdjustmentsResource as aM, type ContractServiceAdjustmentsResourceQueryParams as aN, ContractServiceBundleAdjustmentsResource as aO, type ContractServiceBundleAdjustmentsResourceQueryParams as aP, ContractServiceBundleUnitsResource as aQ, type ContractServiceBundleUnitsResourceQueryParams as aR, ContractServiceBundlesResource as aS, type ContractServiceBundlesResourceQueryParams as aT, ContractServiceUnitsResource as aU, type ContractServiceUnitsResourceQueryParams as aV, ContractServicesResource as aW, type ContractServicesResourceQueryParams as aX, ContractTicketPurchasesResource as aY, type ContractTicketPurchasesResourceQueryParams as aZ, type ContractsProfitabilityResult as a_, ConfigurationItemsResource as aa, type ConfigurationItemsResourceQueryParams as ab, ContactGroupContactsResource as ac, type ContactGroupContactsResourceQueryParams as ad, ContactGroupsResource as ae, type ContactGroupsResourceQueryParams as af, ContactWebhooksResource as ag, type ContactWebhooksResourceQueryParams as ah, ContactsResource as ai, type ContactsResourceQueryParams as aj, ContractBillingRulesResource as ak, type ContractBillingRulesResourceQueryParams as al, ContractBlockHourFactorsResource as am, type ContractBlockHourFactorsResourceQueryParams as an, ContractBlocksResource as ao, type ContractBlocksResourceQueryParams as ap, ContractChargesResource as aq, type ContractChargesResourceQueryParams as ar, ContractExclusionBillingCodesResource as as, type ContractExclusionBillingCodesResourceQueryParams as at, ContractExclusionRolesResource as au, type ContractExclusionRolesResourceQueryParams as av, ContractExclusionSetExcludedRolesResource as aw, type ContractExclusionSetExcludedRolesResourceQueryParams as ax, ContractExclusionSetExcludedWorkTypesResource as ay, type ContractExclusionSetExcludedWorkTypesResourceQueryParams as az, AutotaskError as b, PhasesResource as b$, type ContractsResourceQueryParams as b0, type CooldownStore as b1, type CostRateResolution as b2, CountriesResource as b3, type CountriesResourceQueryParams as b4, CurrenciesResource as b5, type CurrenciesResourceQueryParams as b6, DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD as b7, DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES as b8, DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS as b9, InMemoryCooldownStore as bA, InventoryProductsResource as bB, type InventoryProductsResourceQueryParams as bC, InvoiceTemplatesResource as bD, type InvoiceTemplatesResourceQueryParams as bE, InvoicesResource as bF, type InvoicesResourceQueryParams as bG, type Logger as bH, MAX_PAGES as bI, ModulesResource as bJ, NoopLogger as bK, NotificationHistoryResource as bL, type NotificationHistoryResourceQueryParams as bM, OpportunitiesResource as bN, type OpportunitiesResourceQueryParams as bO, OpportunityAttachmentsResource as bP, type OpportunityAttachmentsResourceQueryParams as bQ, OpportunityCategoriesResource as bR, type OpportunityCategoriesResourceQueryParams as bS, OrganizationalLevel1sResource as bT, type OrganizationalLevel1sResourceQueryParams as bU, OrganizationalLevel2sResource as bV, type OrganizationalLevel2sResourceQueryParams as bW, OrganizationalLevelAssociationsResource as bX, type OrganizationalLevelAssociationsResourceQueryParams as bY, type PageFetcher as bZ, type PaginateOptions as b_, DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE as ba, DEFAULT_CIRCUIT_BREAKER_WINDOW_MS as bb, DEFAULT_COOLDOWN_DEFAULT_MS as bc, DEFAULT_COOLDOWN_MAX_ENTRIES as bd, DEFAULT_COOLDOWN_MAX_MS as be, DEFAULT_ZONE as bf, DepartmentsResource as bg, type DepartmentsResourceQueryParams as bh, DomainRegistrarsResource as bi, type DomainRegistrarsResourceQueryParams as bj, EntityInformationResource as bk, type ErrorCategory as bl, type ErrorIdRef as bm, ExpenseItemAttachmentsResource as bn, type ExpenseItemAttachmentsResourceQueryParams as bo, ExpenseItemsResource as bp, type ExpenseItemsResourceQueryParams as bq, ExpenseReportsResource as br, type ExpenseReportsResourceQueryParams as bs, HolidaySetsResource as bt, type HolidaySetsResourceQueryParams as bu, HolidaysResource as bv, type HolidaysResourceQueryParams as bw, HttpClient as bx, IDEMPOTENT_METHODS as by, InMemoryCircuitBreakerStore as bz, type AutotaskErrorOptions as c, ServiceCallTicketResourcesResource as c$, type PhasesResourceQueryParams as c0, ProductVendorsResource as c1, type ProductVendorsResourceQueryParams as c2, ProductsResource as c3, type ProductsResourceQueryParams as c4, type ProfitRateSource as c5, type ProfitabilityActivityCategory as c6, type ProfitabilityDataQualityWarning as c7, type ProfitabilityHighestCostTicket as c8, type ProfitabilityLabourCostMethod as c9, type QuoteTemplatesResourceQueryParams as cA, QuotesResource as cB, type QuotesResourceQueryParams as cC, READ_CACHE_MAX_ENTRIES as cD, REDACTED as cE, ResourceRoleQueuesResource as cF, type ResourceRoleQueuesResourceQueryParams as cG, ResourceRolesResource as cH, type ResourceRolesResourceQueryParams as cI, ResourceSkillsResource as cJ, type ResourceSkillsResourceQueryParams as cK, ResourceTimeOffAdditionalResource as cL, type ResourceTimeOffAdditionalResourceQueryParams as cM, ResourceTimeOffApproversResource as cN, type ResourceTimeOffApproversResourceQueryParams as cO, ResourceTimeOffBalancesResource as cP, type ResourceTimeOffBalancesResourceQueryParams as cQ, ResourcesResource as cR, type ResourcesResourceQueryParams as cS, RolesResource as cT, type RolesResourceQueryParams as cU, SalesOrdersResource as cV, type SalesOrdersResourceQueryParams as cW, ServiceCallTaskResourcesResource as cX, type ServiceCallTaskResourcesResourceQueryParams as cY, ServiceCallTasksResource as cZ, type ServiceCallTasksResourceQueryParams as c_, type ProfitabilityMiscoding as ca, type ProfitabilityMonthlyRow as cb, type ProfitabilityOpenRenewalItem as cc, type ProfitabilityOptions as cd, type ProfitabilityPart as ce, type ProfitabilityPartDigest as cf, type ProfitabilityRevenueByType as cg, ProjectChargesResource as ch, type ProjectChargesResourceQueryParams as ci, ProjectNotesResource as cj, type ProjectNotesResourceQueryParams as ck, ProjectsResource as cl, type ProjectsResourceQueryParams as cm, PurchaseApprovalsResource as cn, type PurchaseApprovalsResourceQueryParams as co, PurchaseOrderItemReceivingResource as cp, type PurchaseOrderItemReceivingResourceQueryParams as cq, PurchaseOrderItemsResource as cr, type PurchaseOrderItemsResourceQueryParams as cs, PurchaseOrdersResource as ct, type PurchaseOrdersResourceQueryParams as cu, QuoteItemsResource as cv, type QuoteItemsResourceQueryParams as cw, QuoteLocationsResource as cx, type QuoteLocationsResourceQueryParams as cy, QuoteTemplatesResource as cz, type ResolvedAutotaskConfig as d, TicketsResource as d$, type ServiceCallTicketResourcesResourceQueryParams as d0, ServiceCallTicketsResource as d1, type ServiceCallTicketsResourceQueryParams as d2, ServiceCallsResource as d3, type ServiceCallsResourceQueryParams as d4, ServiceLevelAgreementResultsResource as d5, type ServiceLevelAgreementResultsResourceQueryParams as d6, ServicesResource as d7, type ServicesResourceQueryParams as d8, SkillsResource as d9, type TicketAdditionalContactsResourceQueryParams as dA, TicketAttachmentsResource as dB, type TicketAttachmentsResourceQueryParams as dC, TicketCategoriesResource as dD, type TicketCategoriesResourceQueryParams as dE, TicketCategoryFieldDefaultsResource as dF, type TicketCategoryFieldDefaultsResourceQueryParams as dG, TicketChangeRequestApprovalsResource as dH, type TicketChangeRequestApprovalsResourceQueryParams as dI, TicketChargesResource as dJ, type TicketChargesResourceQueryParams as dK, TicketChecklistItemsResource as dL, type TicketChecklistItemsResourceQueryParams as dM, TicketChecklistLibrariesResource as dN, type TicketChecklistLibrariesResourceQueryParams as dO, TicketHistoryResource as dP, type TicketHistoryResourceQueryParams as dQ, TicketNoteAttachmentsResource as dR, type TicketNoteAttachmentsResourceQueryParams as dS, TicketNoteWebhooksResource as dT, type TicketNoteWebhooksResourceQueryParams as dU, TicketNotesResource as dV, type TicketNotesResourceQueryParams as dW, TicketSecondaryResourcesResource as dX, type TicketSecondaryResourcesResourceQueryParams as dY, TicketWebhooksResource as dZ, type TicketWebhooksResourceQueryParams as d_, type SkillsResourceQueryParams as da, SubscriptionPeriodsResource as db, type SubscriptionPeriodsResourceQueryParams as dc, SubscriptionsResource as dd, type SubscriptionsResourceQueryParams as de, SurveyResultsResource as df, type SurveyResultsResourceQueryParams as dg, SurveysResource as dh, type SurveysResourceQueryParams as di, TagAliasesResource as dj, type TagAliasesResourceQueryParams as dk, TagGroupsResource as dl, type TagGroupsResourceQueryParams as dm, TagsResource as dn, type TagsResourceQueryParams as dp, TaskSecondaryResourcesResource as dq, type TaskSecondaryResourcesResourceQueryParams as dr, TasksResource as ds, type TasksResourceQueryParams as dt, TaxRegionsResource as du, type TaxRegionsResourceQueryParams as dv, ThresholdInformationResource as dw, TicketAdditionalConfigurationItemsResource as dx, type TicketAdditionalConfigurationItemsResourceQueryParams as dy, TicketAdditionalContactsResource as dz, type RequestOptions as e, type TicketsResourceQueryParams as e0, TimeEntriesResource as e1, type TimeEntriesResourceQueryParams as e2, TimeEntryAttachmentsResource as e3, type TimeEntryAttachmentsResourceQueryParams as e4, TimeOffRequestsResource as e5, type TimeOffRequestsResourceQueryParams as e6, VersionInformationResource as e7, VersionResource as e8, ZONES as e9, type CreateBlockerKind as eA, type CreateGuidanceReport as eB, type FieldCacheKind as eC, FIELD_CACHE_KINDS as eD, ZONE_CATALOG as ea, ZoneInformationResource as eb, buildBreakerKey as ec, buildTenantKey as ed, clampPageSize as ee, collectAll as ef, cooldownDurationMs as eg, defaultCircuitBreakerStore as eh, defaultCooldownStore as ei, isAutotaskError as ej, isBreakerFailure as ek, isCredentialHeaderName as el, paginate as em, paginateItems as en, redactRecord as eo, resetDefaultCircuitBreakerStore as ep, resetDefaultCooldownStore as eq, resolveBaseUrl as er, toArray as es, totalPagesFor as et, zoneUrl as eu, type BlindSurfaceInfo as ev, type RelationshipResource as ew, type BlindSurfaceInventory as ex, type BlindSurfaceRow as ey, type CreateGuidanceRow as ez, type TicketChangeStatusNoChange as f, AGENT_PROFILE as g, AppointmentsResource as h, type AppointmentsResourceQueryParams as i, AuthenticateResource as j, AutotaskConfigError as k, type BillingCodesResourceQueryParams as l, BillingItemApprovalLevelsResource as m, type BillingItemApprovalLevelsResourceQueryParams as n, BillingItemsResource as o, type BillingItemsResourceQueryParams as p, CREDENTIAL_HEADER_NAMES as q, ChangeRequestLinksResource as r, type ChangeRequestLinksResourceQueryParams as s, ChecklistLibrariesResource as t, type ChecklistLibrariesResourceQueryParams as u, ChecklistLibraryChecklistItemsResource as v, type ChecklistLibraryChecklistItemsResourceQueryParams as w, type CircuitBreakerState as x, type CircuitBreakerStore as y, ClassificationIconsResource as z };
10003
+ export { type ConfigurationItemDnsRecordsResourceQueryParams as $, type AutotaskConfig as A, BillingCodesResource as B, type CreateIfNotExistsResult as C, type ClassificationIconsResourceQueryParams as D, CompaniesResource as E, type CompaniesResourceQueryParams as F, CompanyAlertsResource as G, type CompanyAlertsResourceQueryParams as H, CompanyLocationsResource as I, type CompanyLocationsResourceQueryParams as J, CompanyNotesResource as K, type CompanyNotesResourceQueryParams as L, CompanySiteConfigurationsResource as M, type CompanySiteConfigurationsResourceQueryParams as N, CompanyWebhooksResource as O, type CompanyWebhooksResourceQueryParams as P, type ConfigProfile as Q, ReadCache as R, ConfigurationItemBillingProductAssociationsResource as S, type TicketChangeStatusResult as T, type ConfigurationItemBillingProductAssociationsResourceQueryParams as U, ConfigurationItemCategoriesResource as V, type ConfigurationItemCategoriesResourceQueryParams as W, ConfigurationItemCategoryUdfAssociationsResource as X, type ConfigurationItemCategoryUdfAssociationsResourceQueryParams as Y, type ZoneName as Z, ConfigurationItemDnsRecordsResource as _, AutotaskClient as a, ContractsResource as a$, ConfigurationItemNotesResource as a0, type ConfigurationItemNotesResourceQueryParams as a1, ConfigurationItemRelatedItemsResource as a2, type ConfigurationItemRelatedItemsResourceQueryParams as a3, ConfigurationItemSslSubjectAlternativeNamesResource as a4, type ConfigurationItemSslSubjectAlternativeNamesResourceQueryParams as a5, ConfigurationItemTypesResource as a6, type ConfigurationItemTypesResourceQueryParams as a7, ConfigurationItemWebhooksResource as a8, type ConfigurationItemWebhooksResourceQueryParams as a9, ContractExclusionSetsResource as aA, type ContractExclusionSetsResourceQueryParams as aB, ContractMilestonesResource as aC, type ContractMilestonesResourceQueryParams as aD, ContractNotesResource as aE, type ContractNotesResourceQueryParams as aF, ContractRatesResource as aG, type ContractRatesResourceQueryParams as aH, ContractRetainersResource as aI, type ContractRetainersResourceQueryParams as aJ, ContractRoleCostsResource as aK, type ContractRoleCostsResourceQueryParams as aL, ContractServiceAdjustmentsResource as aM, type ContractServiceAdjustmentsResourceQueryParams as aN, ContractServiceBundleAdjustmentsResource as aO, type ContractServiceBundleAdjustmentsResourceQueryParams as aP, ContractServiceBundleUnitsResource as aQ, type ContractServiceBundleUnitsResourceQueryParams as aR, ContractServiceBundlesResource as aS, type ContractServiceBundlesResourceQueryParams as aT, ContractServiceUnitsResource as aU, type ContractServiceUnitsResourceQueryParams as aV, ContractServicesResource as aW, type ContractServicesResourceQueryParams as aX, ContractTicketPurchasesResource as aY, type ContractTicketPurchasesResourceQueryParams as aZ, type ContractsProfitabilityResult as a_, ConfigurationItemsResource as aa, type ConfigurationItemsResourceQueryParams as ab, ContactGroupContactsResource as ac, type ContactGroupContactsResourceQueryParams as ad, ContactGroupsResource as ae, type ContactGroupsResourceQueryParams as af, ContactWebhooksResource as ag, type ContactWebhooksResourceQueryParams as ah, ContactsResource as ai, type ContactsResourceQueryParams as aj, ContractBillingRulesResource as ak, type ContractBillingRulesResourceQueryParams as al, ContractBlockHourFactorsResource as am, type ContractBlockHourFactorsResourceQueryParams as an, ContractBlocksResource as ao, type ContractBlocksResourceQueryParams as ap, ContractChargesResource as aq, type ContractChargesResourceQueryParams as ar, ContractExclusionBillingCodesResource as as, type ContractExclusionBillingCodesResourceQueryParams as at, ContractExclusionRolesResource as au, type ContractExclusionRolesResourceQueryParams as av, ContractExclusionSetExcludedRolesResource as aw, type ContractExclusionSetExcludedRolesResourceQueryParams as ax, ContractExclusionSetExcludedWorkTypesResource as ay, type ContractExclusionSetExcludedWorkTypesResourceQueryParams as az, AutotaskError as b, PhasesResource as b$, type ContractsResourceQueryParams as b0, type CooldownStore as b1, type CostRateResolution as b2, CountriesResource as b3, type CountriesResourceQueryParams as b4, CurrenciesResource as b5, type CurrenciesResourceQueryParams as b6, DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD as b7, DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES as b8, DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS as b9, InMemoryCooldownStore as bA, InventoryProductsResource as bB, type InventoryProductsResourceQueryParams as bC, InvoiceTemplatesResource as bD, type InvoiceTemplatesResourceQueryParams as bE, InvoicesResource as bF, type InvoicesResourceQueryParams as bG, type Logger as bH, MAX_PAGES as bI, ModulesResource as bJ, NoopLogger as bK, NotificationHistoryResource as bL, type NotificationHistoryResourceQueryParams as bM, OpportunitiesResource as bN, type OpportunitiesResourceQueryParams as bO, OpportunityAttachmentsResource as bP, type OpportunityAttachmentsResourceQueryParams as bQ, OpportunityCategoriesResource as bR, type OpportunityCategoriesResourceQueryParams as bS, OrganizationalLevel1sResource as bT, type OrganizationalLevel1sResourceQueryParams as bU, OrganizationalLevel2sResource as bV, type OrganizationalLevel2sResourceQueryParams as bW, OrganizationalLevelAssociationsResource as bX, type OrganizationalLevelAssociationsResourceQueryParams as bY, type PageFetcher as bZ, type PaginateOptions as b_, DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE as ba, DEFAULT_CIRCUIT_BREAKER_WINDOW_MS as bb, DEFAULT_COOLDOWN_DEFAULT_MS as bc, DEFAULT_COOLDOWN_MAX_ENTRIES as bd, DEFAULT_COOLDOWN_MAX_MS as be, DEFAULT_ZONE as bf, DepartmentsResource as bg, type DepartmentsResourceQueryParams as bh, DomainRegistrarsResource as bi, type DomainRegistrarsResourceQueryParams as bj, EntityInformationResource as bk, type ErrorCategory as bl, type ErrorIdRef as bm, ExpenseItemAttachmentsResource as bn, type ExpenseItemAttachmentsResourceQueryParams as bo, ExpenseItemsResource as bp, type ExpenseItemsResourceQueryParams as bq, ExpenseReportsResource as br, type ExpenseReportsResourceQueryParams as bs, HolidaySetsResource as bt, type HolidaySetsResourceQueryParams as bu, HolidaysResource as bv, type HolidaysResourceQueryParams as bw, HttpClient as bx, IDEMPOTENT_METHODS as by, InMemoryCircuitBreakerStore as bz, type AutotaskErrorOptions as c, ServiceCallTicketResourcesResource as c$, type PhasesResourceQueryParams as c0, ProductVendorsResource as c1, type ProductVendorsResourceQueryParams as c2, ProductsResource as c3, type ProductsResourceQueryParams as c4, type ProfitRateSource as c5, type ProfitabilityActivityCategory as c6, type ProfitabilityDataQualityWarning as c7, type ProfitabilityHighestCostTicket as c8, type ProfitabilityLabourCostMethod as c9, type QuoteTemplatesResourceQueryParams as cA, QuotesResource as cB, type QuotesResourceQueryParams as cC, READ_CACHE_MAX_ENTRIES as cD, REDACTED as cE, ResourceRoleQueuesResource as cF, type ResourceRoleQueuesResourceQueryParams as cG, ResourceRolesResource as cH, type ResourceRolesResourceQueryParams as cI, ResourceSkillsResource as cJ, type ResourceSkillsResourceQueryParams as cK, ResourceTimeOffAdditionalResource as cL, type ResourceTimeOffAdditionalResourceQueryParams as cM, ResourceTimeOffApproversResource as cN, type ResourceTimeOffApproversResourceQueryParams as cO, ResourceTimeOffBalancesResource as cP, type ResourceTimeOffBalancesResourceQueryParams as cQ, ResourcesResource as cR, type ResourcesResourceQueryParams as cS, RolesResource as cT, type RolesResourceQueryParams as cU, SalesOrdersResource as cV, type SalesOrdersResourceQueryParams as cW, ServiceCallTaskResourcesResource as cX, type ServiceCallTaskResourcesResourceQueryParams as cY, ServiceCallTasksResource as cZ, type ServiceCallTasksResourceQueryParams as c_, type ProfitabilityMiscoding as ca, type ProfitabilityMonthlyRow as cb, type ProfitabilityOpenRenewalItem as cc, type ProfitabilityOptions as cd, type ProfitabilityPart as ce, type ProfitabilityPartDigest as cf, type ProfitabilityRevenueByType as cg, ProjectChargesResource as ch, type ProjectChargesResourceQueryParams as ci, ProjectNotesResource as cj, type ProjectNotesResourceQueryParams as ck, ProjectsResource as cl, type ProjectsResourceQueryParams as cm, PurchaseApprovalsResource as cn, type PurchaseApprovalsResourceQueryParams as co, PurchaseOrderItemReceivingResource as cp, type PurchaseOrderItemReceivingResourceQueryParams as cq, PurchaseOrderItemsResource as cr, type PurchaseOrderItemsResourceQueryParams as cs, PurchaseOrdersResource as ct, type PurchaseOrdersResourceQueryParams as cu, QuoteItemsResource as cv, type QuoteItemsResourceQueryParams as cw, QuoteLocationsResource as cx, type QuoteLocationsResourceQueryParams as cy, QuoteTemplatesResource as cz, type ResolvedAutotaskConfig as d, TicketsResource as d$, type ServiceCallTicketResourcesResourceQueryParams as d0, ServiceCallTicketsResource as d1, type ServiceCallTicketsResourceQueryParams as d2, ServiceCallsResource as d3, type ServiceCallsResourceQueryParams as d4, ServiceLevelAgreementResultsResource as d5, type ServiceLevelAgreementResultsResourceQueryParams as d6, ServicesResource as d7, type ServicesResourceQueryParams as d8, SkillsResource as d9, type TicketAdditionalContactsResourceQueryParams as dA, TicketAttachmentsResource as dB, type TicketAttachmentsResourceQueryParams as dC, TicketCategoriesResource as dD, type TicketCategoriesResourceQueryParams as dE, TicketCategoryFieldDefaultsResource as dF, type TicketCategoryFieldDefaultsResourceQueryParams as dG, TicketChangeRequestApprovalsResource as dH, type TicketChangeRequestApprovalsResourceQueryParams as dI, TicketChargesResource as dJ, type TicketChargesResourceQueryParams as dK, TicketChecklistItemsResource as dL, type TicketChecklistItemsResourceQueryParams as dM, TicketChecklistLibrariesResource as dN, type TicketChecklistLibrariesResourceQueryParams as dO, TicketHistoryResource as dP, type TicketHistoryResourceQueryParams as dQ, TicketNoteAttachmentsResource as dR, type TicketNoteAttachmentsResourceQueryParams as dS, TicketNoteWebhooksResource as dT, type TicketNoteWebhooksResourceQueryParams as dU, TicketNotesResource as dV, type TicketNotesResourceQueryParams as dW, TicketSecondaryResourcesResource as dX, type TicketSecondaryResourcesResourceQueryParams as dY, TicketWebhooksResource as dZ, type TicketWebhooksResourceQueryParams as d_, type SkillsResourceQueryParams as da, SubscriptionPeriodsResource as db, type SubscriptionPeriodsResourceQueryParams as dc, SubscriptionsResource as dd, type SubscriptionsResourceQueryParams as de, SurveyResultsResource as df, type SurveyResultsResourceQueryParams as dg, SurveysResource as dh, type SurveysResourceQueryParams as di, TagAliasesResource as dj, type TagAliasesResourceQueryParams as dk, TagGroupsResource as dl, type TagGroupsResourceQueryParams as dm, TagsResource as dn, type TagsResourceQueryParams as dp, TaskSecondaryResourcesResource as dq, type TaskSecondaryResourcesResourceQueryParams as dr, TasksResource as ds, type TasksResourceQueryParams as dt, TaxRegionsResource as du, type TaxRegionsResourceQueryParams as dv, ThresholdInformationResource as dw, TicketAdditionalConfigurationItemsResource as dx, type TicketAdditionalConfigurationItemsResourceQueryParams as dy, TicketAdditionalContactsResource as dz, type RequestOptions as e, type TicketsResourceQueryParams as e0, type TimeEntriesPostedCountResult as e1, type TimeEntriesPostedPagingOptions as e2, type TimeEntriesPostedStateResult as e3, type TimeEntriesPostedWindowCountOptions as e4, type TimeEntriesPostedWindowListOptions as e5, type TimeEntriesPostedWindowOptions as e6, type TimeEntriesPostedWindowResult as e7, TimeEntriesResource as e8, type TimeEntriesResourceQueryParams as e9, resetDefaultCooldownStore as eA, resolveBaseUrl as eB, toArray as eC, totalPagesFor as eD, zoneUrl as eE, type BlindSurfaceInfo as eF, type RelationshipResource as eG, type BlindSurfaceInventory as eH, type BlindSurfaceRow as eI, type CreateGuidanceValueRequirement as eJ, type CreateGuidanceRow as eK, type CreateBlockerKind as eL, type CreateGuidanceReport as eM, type FieldCacheKind as eN, FIELD_CACHE_KINDS as eO, type TimeEntriesStatusCountOptions as ea, type TimeEntriesStatusListOptions as eb, type TimeEntriesStatusOptions as ec, TimeEntryAttachmentsResource as ed, type TimeEntryAttachmentsResourceQueryParams as ee, TimeOffRequestsResource as ef, type TimeOffRequestsResourceQueryParams as eg, VersionInformationResource as eh, VersionResource as ei, ZONES as ej, ZONE_CATALOG as ek, ZoneInformationResource as el, buildBreakerKey as em, buildTenantKey as en, clampPageSize as eo, collectAll as ep, cooldownDurationMs as eq, defaultCircuitBreakerStore as er, defaultCooldownStore as es, isAutotaskError as et, isBreakerFailure as eu, isCredentialHeaderName as ev, paginate as ew, paginateItems as ex, redactRecord as ey, resetDefaultCircuitBreakerStore as ez, type TicketChangeStatusNoChange as f, AGENT_PROFILE as g, AppointmentsResource as h, type AppointmentsResourceQueryParams as i, AuthenticateResource as j, AutotaskConfigError as k, type BillingCodesResourceQueryParams as l, BillingItemApprovalLevelsResource as m, type BillingItemApprovalLevelsResourceQueryParams as n, BillingItemsResource as o, type BillingItemsResourceQueryParams as p, CREDENTIAL_HEADER_NAMES as q, ChangeRequestLinksResource as r, type ChangeRequestLinksResourceQueryParams as s, ChecklistLibrariesResource as t, type ChecklistLibrariesResourceQueryParams as u, ChecklistLibraryChecklistItemsResource as v, type ChecklistLibraryChecklistItemsResourceQueryParams as w, type CircuitBreakerState as x, type CircuitBreakerStore as y, ClassificationIconsResource as z };