node-autotask 0.33.0 → 0.34.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 (39) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/MCP_TOOL_CATALOG.json +2 -2
  3. package/MCP_TOOL_MANIFEST.md +4 -4
  4. package/N8N_MCP_MANIFEST.json +2 -2
  5. package/N8N_MCP_MANIFEST.md +3 -3
  6. package/capabilities.json +4084 -2544
  7. package/capabilities.schema.json +32 -0
  8. package/dist/capabilities.cjs +2 -2
  9. package/dist/capabilities.d.cts +13 -1
  10. package/dist/capabilities.d.ts +13 -1
  11. package/dist/capabilities.js +1 -1
  12. package/dist/{chunk-VKE56TTN.js → chunk-4MUBUSTL.js} +4083 -2543
  13. package/dist/{chunk-5DS6F6GF.js → chunk-6ADFCU3I.js} +399 -342
  14. package/dist/{chunk-OO67MRHN.cjs → chunk-DKJP73FX.cjs} +966 -909
  15. package/dist/{chunk-MFDQHFGJ.js → chunk-EZKM4HQ6.js} +1017 -577
  16. package/dist/{chunk-SP2SJJZX.cjs → chunk-FOOHJBPP.cjs} +4083 -2543
  17. package/dist/{chunk-4QN43TRP.cjs → chunk-GDQ4QM7Q.cjs} +1066 -626
  18. package/dist/{chunk-3LAZZT7V.cjs → chunk-P6YN2POI.cjs} +143 -143
  19. package/dist/{chunk-7WNE5MPG.js → chunk-RDFL5QYE.js} +2 -2
  20. package/dist/{index-BaeMHZPk.d.ts → index-ByMU8IC2.d.ts} +498 -198
  21. package/dist/{index-Cq0VsfSz.d.cts → index-Dx4-zpDo.d.cts} +498 -198
  22. package/dist/index.cjs +23 -23
  23. package/dist/index.d.cts +2 -2
  24. package/dist/index.d.ts +2 -2
  25. package/dist/index.js +5 -5
  26. package/dist/operations/index.cjs +157 -116
  27. package/dist/operations/index.d.cts +39 -25
  28. package/dist/operations/index.d.ts +39 -25
  29. package/dist/operations/index.js +47 -6
  30. package/dist/pool.cjs +9 -9
  31. package/dist/pool.d.cts +1 -1
  32. package/dist/pool.d.ts +1 -1
  33. package/dist/pool.js +4 -4
  34. package/dist/resources/index.cjs +4 -4
  35. package/dist/resources/index.d.cts +1 -1
  36. package/dist/resources/index.d.ts +1 -1
  37. package/dist/resources/index.js +3 -3
  38. package/docs/API.md +160 -35
  39. 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: 08cf890fa1b2b50574638a1364993fced7e83a5dfd4f630763d80cdc01d5a5f1
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;
@@ -1611,6 +1624,8 @@ interface RelationshipResource {
1611
1624
  remedy: string;
1612
1625
  /** The declared create requirement (issue #219 N3). */
1613
1626
  requires?: CreateGuidanceRequires;
1627
+ /** True when the API cannot satisfy this create for any input (issue #246). */
1628
+ unsatisfiableViaApi?: boolean;
1614
1629
  } | null;
1615
1630
  vendorEvidence: string[];
1616
1631
  deleteBoundary: {
@@ -1622,6 +1637,8 @@ interface RelationshipResource {
1622
1637
  requiresByValue?: CreateGuidanceValueRequirement[];
1623
1638
  /** Picklist values the vendor rejects (issue #219 N3). */
1624
1639
  rejectedValues?: CreateGuidanceRejectedValue[];
1640
+ /** Spec-derived parent-company hint (issue #246). */
1641
+ parentCompany?: CreateGuidanceParentCompany;
1625
1642
  };
1626
1643
  } | null;
1627
1644
  /** The spec-derived delete boundary (issue #9; null = the vendor defines a DELETE). */
@@ -2303,8 +2320,10 @@ declare class AppointmentsResource extends BaseResource<Appointment, Appointment
2303
2320
  queryAll(params?: AppointmentsResourceQueryParams): Promise<Appointment[]>;
2304
2321
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2305
2322
  count(params?: AppointmentsResourceQueryParams): Promise<number>;
2306
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2307
- get(id: Identifier): Promise<Appointment>;
2323
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2324
+ get(id: Identifier, opts?: {
2325
+ fresh?: boolean;
2326
+ } | null): Promise<Appointment>;
2308
2327
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
2309
2328
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2310
2329
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2366,8 +2385,10 @@ declare class BillingCodesResource extends BaseResource<BillingCode, BillingCode
2366
2385
  queryAll(params?: BillingCodesResourceQueryParams): Promise<BillingCode[]>;
2367
2386
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2368
2387
  count(params?: BillingCodesResourceQueryParams): Promise<number>;
2369
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2370
- get(id: Identifier): Promise<BillingCode>;
2388
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2389
+ get(id: Identifier, opts?: {
2390
+ fresh?: boolean;
2391
+ } | null): Promise<BillingCode>;
2371
2392
  /** Resolve a BillingCode from a numeric id (or, where the vendor indexes a primary text field,
2372
2393
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
2373
2394
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -2400,8 +2421,10 @@ declare class BillingItemApprovalLevelsResource extends BaseResource<BillingItem
2400
2421
  queryAll(params?: BillingItemApprovalLevelsResourceQueryParams): Promise<BillingItemApprovalLevel[]>;
2401
2422
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2402
2423
  count(params?: BillingItemApprovalLevelsResourceQueryParams): Promise<number>;
2403
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2404
- get(id: Identifier): Promise<BillingItemApprovalLevel>;
2424
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2425
+ get(id: Identifier, opts?: {
2426
+ fresh?: boolean;
2427
+ } | null): Promise<BillingItemApprovalLevel>;
2405
2428
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
2406
2429
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2407
2430
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2436,8 +2459,10 @@ declare class BillingItemsResource extends BaseResource<BillingItems, BillingIte
2436
2459
  queryAll(params?: BillingItemsResourceQueryParams): Promise<BillingItems[]>;
2437
2460
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2438
2461
  count(params?: BillingItemsResourceQueryParams): Promise<number>;
2439
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2440
- get(id: Identifier): Promise<BillingItems>;
2462
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2463
+ get(id: Identifier, opts?: {
2464
+ fresh?: boolean;
2465
+ } | null): Promise<BillingItems>;
2441
2466
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
2442
2467
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
2443
2468
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -2500,8 +2525,10 @@ declare class ChangeRequestLinksResource extends BaseResource<ChangeRequestLink,
2500
2525
  queryAll(params?: ChangeRequestLinksResourceQueryParams): Promise<ChangeRequestLink[]>;
2501
2526
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2502
2527
  count(params?: ChangeRequestLinksResourceQueryParams): Promise<number>;
2503
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2504
- get(id: Identifier): Promise<ChangeRequestLink>;
2528
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2529
+ get(id: Identifier, opts?: {
2530
+ fresh?: boolean;
2531
+ } | null): Promise<ChangeRequestLink>;
2505
2532
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
2506
2533
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2507
2534
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2538,8 +2565,10 @@ declare class ChecklistLibrariesResource extends BaseResource<ChecklistLibrary,
2538
2565
  queryAll(params?: ChecklistLibrariesResourceQueryParams): Promise<ChecklistLibrary[]>;
2539
2566
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2540
2567
  count(params?: ChecklistLibrariesResourceQueryParams): Promise<number>;
2541
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2542
- get(id: Identifier): Promise<ChecklistLibrary>;
2568
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2569
+ get(id: Identifier, opts?: {
2570
+ fresh?: boolean;
2571
+ } | null): Promise<ChecklistLibrary>;
2543
2572
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
2544
2573
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2545
2574
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2593,7 +2622,9 @@ declare class ChecklistLibraryChecklistItemsResource extends BaseResource<Checkl
2593
2622
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2594
2623
  count(params?: ChecklistLibraryChecklistItemsResourceQueryParams): Promise<number>;
2595
2624
  /** 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>;
2625
+ get(parentId: Identifier, id: Identifier, opts?: {
2626
+ fresh?: boolean;
2627
+ } | null): Promise<ChecklistLibraryChecklistItem>;
2597
2628
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
2598
2629
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2599
2630
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -2635,8 +2666,10 @@ declare class ClassificationIconsResource extends BaseResource<ClassificationIco
2635
2666
  queryAll(params?: ClassificationIconsResourceQueryParams): Promise<ClassificationIcon[]>;
2636
2667
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2637
2668
  count(params?: ClassificationIconsResourceQueryParams): Promise<number>;
2638
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2639
- get(id: Identifier): Promise<ClassificationIcon>;
2669
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
2670
+ get(id: Identifier, opts?: {
2671
+ fresh?: boolean;
2672
+ } | null): Promise<ClassificationIcon>;
2640
2673
  /** Resolve a ClassificationIcon from a numeric id (or, where the vendor indexes a primary text field,
2641
2674
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
2642
2675
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -2749,6 +2782,8 @@ interface TicketStatusOptions {
2749
2782
  fresh?: boolean;
2750
2783
  /** Explicit closed ids: the caller's override wins over the picklist and is reported as `picklist` (a caller decision is not an assumption). */
2751
2784
  excludeStatusIds?: readonly number[];
2785
+ /** 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. */
2786
+ allowAssumed?: boolean;
2752
2787
  }
2753
2788
 
2754
2789
  /** The list parts that accept a per-part field projection (issue #200). `company` is the single get and is not projectable. */
@@ -2772,6 +2807,10 @@ interface CompanyFullProfileOptions {
2772
2807
  names?: boolean;
2773
2808
  /** 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
2809
  maxNameReads?: number;
2810
+ /** Explicit closed ticket-status ids for the openTickets part, overriding the resolved picklist (a caller decision, reported as source 'picklist'; same as tickets.forResource). */
2811
+ excludeStatusIds?: number[];
2812
+ /** `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. */
2813
+ allowAssumed?: boolean;
2775
2814
  }
2776
2815
  /** One capped list part (a full page sets `capped: true` — more may exist). */
2777
2816
  interface CompanyFullProfilePart<TItem> {
@@ -3029,8 +3068,10 @@ declare class CompaniesResource extends BaseResource<Company, CompanyCreate, Com
3029
3068
  queryAll(params?: CompaniesResourceQueryParams): Promise<Company[]>;
3030
3069
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3031
3070
  count(params?: CompaniesResourceQueryParams): Promise<number>;
3032
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3033
- get(id: Identifier): Promise<Company>;
3071
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3072
+ get(id: Identifier, opts?: {
3073
+ fresh?: boolean;
3074
+ } | null): Promise<Company>;
3034
3075
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3035
3076
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3036
3077
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3110,7 +3151,9 @@ declare class CompanyAlertsResource extends BaseResource<CompanyAlert, CompanyAl
3110
3151
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3111
3152
  count(params?: CompanyAlertsResourceQueryParams): Promise<number>;
3112
3153
  /** 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>;
3154
+ get(parentId: Identifier, id: Identifier, opts?: {
3155
+ fresh?: boolean;
3156
+ } | null): Promise<CompanyAlert>;
3114
3157
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3115
3158
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3116
3159
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3155,7 +3198,9 @@ declare class CompanyLocationsResource extends BaseResource<CompanyLocation, Com
3155
3198
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3156
3199
  count(params?: CompanyLocationsResourceQueryParams): Promise<number>;
3157
3200
  /** 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>;
3201
+ get(parentId: Identifier, id: Identifier, opts?: {
3202
+ fresh?: boolean;
3203
+ } | null): Promise<CompanyLocation>;
3159
3204
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3160
3205
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3161
3206
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3204,7 +3249,9 @@ declare class CompanyNotesResource extends BaseResource<CompanyNote, CompanyNote
3204
3249
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3205
3250
  count(params?: CompanyNotesResourceQueryParams): Promise<number>;
3206
3251
  /** 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>;
3252
+ get(parentId: Identifier, id: Identifier, opts?: {
3253
+ fresh?: boolean;
3254
+ } | null): Promise<CompanyNote>;
3208
3255
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3209
3256
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3210
3257
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3250,7 +3297,9 @@ declare class CompanySiteConfigurationsResource extends BaseResource<CompanySite
3250
3297
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3251
3298
  count(params?: CompanySiteConfigurationsResourceQueryParams): Promise<number>;
3252
3299
  /** 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>;
3300
+ get(parentId: Identifier, id: Identifier, opts?: {
3301
+ fresh?: boolean;
3302
+ } | null): Promise<CompanySiteConfigurations>;
3254
3303
  /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
3255
3304
  * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
3256
3305
  * the pinned envelope with the best-effort diff; a caller-supplied lastModifiedDate that
@@ -3286,8 +3335,10 @@ declare class CompanyWebhooksResource extends BaseResource<CompanyWebhook, Compa
3286
3335
  queryAll(params?: CompanyWebhooksResourceQueryParams): Promise<CompanyWebhook[]>;
3287
3336
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3288
3337
  count(params?: CompanyWebhooksResourceQueryParams): Promise<number>;
3289
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3290
- get(id: Identifier): Promise<CompanyWebhook>;
3338
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3339
+ get(id: Identifier, opts?: {
3340
+ fresh?: boolean;
3341
+ } | null): Promise<CompanyWebhook>;
3291
3342
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3292
3343
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3293
3344
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3341,7 +3392,9 @@ declare class ConfigurationItemBillingProductAssociationsResource extends BaseRe
3341
3392
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3342
3393
  count(params?: ConfigurationItemBillingProductAssociationsResourceQueryParams): Promise<number>;
3343
3394
  /** 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>;
3395
+ get(parentId: Identifier, id: Identifier, opts?: {
3396
+ fresh?: boolean;
3397
+ } | null): Promise<ConfigurationItemBillingProductAssociations>;
3345
3398
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3346
3399
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3347
3400
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3383,8 +3436,10 @@ declare class ConfigurationItemCategoriesResource extends BaseResource<Configura
3383
3436
  queryAll(params?: ConfigurationItemCategoriesResourceQueryParams): Promise<ConfigurationItemCategory[]>;
3384
3437
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3385
3438
  count(params?: ConfigurationItemCategoriesResourceQueryParams): Promise<number>;
3386
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3387
- get(id: Identifier): Promise<ConfigurationItemCategory>;
3439
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3440
+ get(id: Identifier, opts?: {
3441
+ fresh?: boolean;
3442
+ } | null): Promise<ConfigurationItemCategory>;
3388
3443
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3389
3444
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3390
3445
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3435,7 +3490,9 @@ declare class ConfigurationItemCategoryUdfAssociationsResource extends BaseResou
3435
3490
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3436
3491
  count(params?: ConfigurationItemCategoryUdfAssociationsResourceQueryParams): Promise<number>;
3437
3492
  /** 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>;
3493
+ get(parentId: Identifier, id: Identifier, opts?: {
3494
+ fresh?: boolean;
3495
+ } | null): Promise<ConfigurationItemCategoryUdfAssociation>;
3439
3496
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3440
3497
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3441
3498
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3480,7 +3537,9 @@ declare class ConfigurationItemDnsRecordsResource extends BaseResource<Configura
3480
3537
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3481
3538
  count(params?: ConfigurationItemDnsRecordsResourceQueryParams): Promise<number>;
3482
3539
  /** 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>;
3540
+ get(parentId: Identifier, id: Identifier, opts?: {
3541
+ fresh?: boolean;
3542
+ } | null): Promise<ConfigurationItemDnsRecord>;
3484
3543
  /** Delete a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the pinned
3485
3544
  * envelope and never issues the delete. */
3486
3545
  delete(parentId: Identifier, id: Identifier, opts?: MutationOpts): Promise<OperationResult | DryRunResult<Record<string, unknown>>>;
@@ -3515,7 +3574,9 @@ declare class ConfigurationItemNotesResource extends BaseResource<ConfigurationI
3515
3574
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3516
3575
  count(params?: ConfigurationItemNotesResourceQueryParams): Promise<number>;
3517
3576
  /** 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>;
3577
+ get(parentId: Identifier, id: Identifier, opts?: {
3578
+ fresh?: boolean;
3579
+ } | null): Promise<ConfigurationItemNote>;
3519
3580
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3520
3581
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3521
3582
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3557,7 +3618,9 @@ declare class ConfigurationItemRelatedItemsResource extends BaseResource<Configu
3557
3618
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3558
3619
  count(params?: ConfigurationItemRelatedItemsResourceQueryParams): Promise<number>;
3559
3620
  /** 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>;
3621
+ get(parentId: Identifier, id: Identifier, opts?: {
3622
+ fresh?: boolean;
3623
+ } | null): Promise<ConfigurationItemRelatedItem>;
3561
3624
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3562
3625
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3563
3626
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3680,8 +3743,10 @@ declare class ConfigurationItemsResource extends BaseResource<ConfigurationItem,
3680
3743
  queryAll(params?: ConfigurationItemsResourceQueryParams): Promise<ConfigurationItem[]>;
3681
3744
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3682
3745
  count(params?: ConfigurationItemsResourceQueryParams): Promise<number>;
3683
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3684
- get(id: Identifier): Promise<ConfigurationItem>;
3746
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3747
+ get(id: Identifier, opts?: {
3748
+ fresh?: boolean;
3749
+ } | null): Promise<ConfigurationItem>;
3685
3750
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3686
3751
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3687
3752
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3741,7 +3806,9 @@ declare class ConfigurationItemSslSubjectAlternativeNamesResource extends BaseRe
3741
3806
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3742
3807
  count(params?: ConfigurationItemSslSubjectAlternativeNamesResourceQueryParams): Promise<number>;
3743
3808
  /** 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>;
3809
+ get(parentId: Identifier, id: Identifier, opts?: {
3810
+ fresh?: boolean;
3811
+ } | null): Promise<ConfigurationItemSslSubjectAlternativeName>;
3745
3812
  /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
3746
3813
  * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
3747
3814
  * the pinned envelope with the best-effort diff; a caller-supplied lastModifiedDate that
@@ -3782,8 +3849,10 @@ declare class ConfigurationItemTypesResource extends BaseResource<ConfigurationI
3782
3849
  queryAll(params?: ConfigurationItemTypesResourceQueryParams): Promise<ConfigurationItemType[]>;
3783
3850
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3784
3851
  count(params?: ConfigurationItemTypesResourceQueryParams): Promise<number>;
3785
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3786
- get(id: Identifier): Promise<ConfigurationItemType>;
3852
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3853
+ get(id: Identifier, opts?: {
3854
+ fresh?: boolean;
3855
+ } | null): Promise<ConfigurationItemType>;
3787
3856
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3788
3857
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3789
3858
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3836,8 +3905,10 @@ declare class ConfigurationItemWebhooksResource extends BaseResource<Configurati
3836
3905
  queryAll(params?: ConfigurationItemWebhooksResourceQueryParams): Promise<ConfigurationItemWebhook[]>;
3837
3906
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3838
3907
  count(params?: ConfigurationItemWebhooksResourceQueryParams): Promise<number>;
3839
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3840
- get(id: Identifier): Promise<ConfigurationItemWebhook>;
3908
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3909
+ get(id: Identifier, opts?: {
3910
+ fresh?: boolean;
3911
+ } | null): Promise<ConfigurationItemWebhook>;
3841
3912
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3842
3913
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3843
3914
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3888,8 +3959,10 @@ declare class ContactGroupContactsResource extends BaseResource<ContactGroupCont
3888
3959
  queryAll(params?: ContactGroupContactsResourceQueryParams): Promise<ContactGroupContacts[]>;
3889
3960
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3890
3961
  count(params?: ContactGroupContactsResourceQueryParams): Promise<number>;
3891
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3892
- get(id: Identifier): Promise<ContactGroupContacts>;
3962
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
3963
+ get(id: Identifier, opts?: {
3964
+ fresh?: boolean;
3965
+ } | null): Promise<ContactGroupContacts>;
3893
3966
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3894
3967
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3895
3968
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3926,8 +3999,10 @@ declare class ContactGroupsResource extends BaseResource<ContactGroups, ContactG
3926
3999
  queryAll(params?: ContactGroupsResourceQueryParams): Promise<ContactGroups[]>;
3927
4000
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3928
4001
  count(params?: ContactGroupsResourceQueryParams): Promise<number>;
3929
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3930
- get(id: Identifier): Promise<ContactGroups>;
4002
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
4003
+ get(id: Identifier, opts?: {
4004
+ fresh?: boolean;
4005
+ } | null): Promise<ContactGroups>;
3931
4006
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3932
4007
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3933
4008
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4038,7 +4113,9 @@ declare class ContactsResource extends BaseResource<Contact, ContactCreate, Cont
4038
4113
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4039
4114
  count(params?: ContactsResourceQueryParams): Promise<number>;
4040
4115
  /** 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>;
4116
+ get(parentId: Identifier, id: Identifier, opts?: {
4117
+ fresh?: boolean;
4118
+ } | null): Promise<Contact>;
4042
4119
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4043
4120
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4044
4121
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4095,8 +4172,10 @@ declare class ContactWebhooksResource extends BaseResource<ContactWebhook, Conta
4095
4172
  queryAll(params?: ContactWebhooksResourceQueryParams): Promise<ContactWebhook[]>;
4096
4173
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4097
4174
  count(params?: ContactWebhooksResourceQueryParams): Promise<number>;
4098
- /** Get one record by id (item envelope; item: null → NotFoundError). */
4099
- get(id: Identifier): Promise<ContactWebhook>;
4175
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
4176
+ get(id: Identifier, opts?: {
4177
+ fresh?: boolean;
4178
+ } | null): Promise<ContactWebhook>;
4100
4179
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
4101
4180
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4102
4181
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4150,7 +4229,9 @@ declare class ContractBillingRulesResource extends BaseResource<ContractBillingR
4150
4229
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4151
4230
  count(params?: ContractBillingRulesResourceQueryParams): Promise<number>;
4152
4231
  /** 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>;
4232
+ get(parentId: Identifier, id: Identifier, opts?: {
4233
+ fresh?: boolean;
4234
+ } | null): Promise<ContractBillingRule>;
4154
4235
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4155
4236
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4156
4237
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4195,7 +4276,9 @@ declare class ContractBlockHourFactorsResource extends BaseResource<ContractBloc
4195
4276
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4196
4277
  count(params?: ContractBlockHourFactorsResourceQueryParams): Promise<number>;
4197
4278
  /** 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>;
4279
+ get(parentId: Identifier, id: Identifier, opts?: {
4280
+ fresh?: boolean;
4281
+ } | null): Promise<ContractBlockHourFactor>;
4199
4282
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4200
4283
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4201
4284
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4237,7 +4320,9 @@ declare class ContractBlocksResource extends BaseResource<ContractBlock, Contrac
4237
4320
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4238
4321
  count(params?: ContractBlocksResourceQueryParams): Promise<number>;
4239
4322
  /** 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>;
4323
+ get(parentId: Identifier, id: Identifier, opts?: {
4324
+ fresh?: boolean;
4325
+ } | null): Promise<ContractBlock>;
4241
4326
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4242
4327
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4243
4328
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4279,7 +4364,9 @@ declare class ContractChargesResource extends BaseResource<ContractCharge, Contr
4279
4364
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4280
4365
  count(params?: ContractChargesResourceQueryParams): Promise<number>;
4281
4366
  /** 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>;
4367
+ get(parentId: Identifier, id: Identifier, opts?: {
4368
+ fresh?: boolean;
4369
+ } | null): Promise<ContractCharge>;
4283
4370
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4284
4371
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4285
4372
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4328,7 +4415,9 @@ declare class ContractExclusionBillingCodesResource extends BaseResource<Contrac
4328
4415
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4329
4416
  count(params?: ContractExclusionBillingCodesResourceQueryParams): Promise<number>;
4330
4417
  /** 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>;
4418
+ get(parentId: Identifier, id: Identifier, opts?: {
4419
+ fresh?: boolean;
4420
+ } | null): Promise<ContractExclusionBillingCode>;
4332
4421
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4333
4422
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4334
4423
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4368,7 +4457,9 @@ declare class ContractExclusionRolesResource extends BaseResource<ContractExclus
4368
4457
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4369
4458
  count(params?: ContractExclusionRolesResourceQueryParams): Promise<number>;
4370
4459
  /** 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>;
4460
+ get(parentId: Identifier, id: Identifier, opts?: {
4461
+ fresh?: boolean;
4462
+ } | null): Promise<ContractExclusionRoles>;
4372
4463
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4373
4464
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4374
4465
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4408,7 +4499,9 @@ declare class ContractExclusionSetExcludedRolesResource extends BaseResource<Con
4408
4499
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4409
4500
  count(params?: ContractExclusionSetExcludedRolesResourceQueryParams): Promise<number>;
4410
4501
  /** 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>;
4502
+ get(parentId: Identifier, id: Identifier, opts?: {
4503
+ fresh?: boolean;
4504
+ } | null): Promise<ContractExclusionSetExcludedRoles>;
4412
4505
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4413
4506
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4414
4507
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4448,7 +4541,9 @@ declare class ContractExclusionSetExcludedWorkTypesResource extends BaseResource
4448
4541
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4449
4542
  count(params?: ContractExclusionSetExcludedWorkTypesResourceQueryParams): Promise<number>;
4450
4543
  /** 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>;
4544
+ get(parentId: Identifier, id: Identifier, opts?: {
4545
+ fresh?: boolean;
4546
+ } | null): Promise<ContractExclusionSetExcludedWorkTypes>;
4452
4547
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4453
4548
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4454
4549
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4485,8 +4580,10 @@ declare class ContractExclusionSetsResource extends BaseResource<ContractExclusi
4485
4580
  queryAll(params?: ContractExclusionSetsResourceQueryParams): Promise<ContractExclusionSets[]>;
4486
4581
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4487
4582
  count(params?: ContractExclusionSetsResourceQueryParams): Promise<number>;
4488
- /** Get one record by id (item envelope; item: null → NotFoundError). */
4489
- get(id: Identifier): Promise<ContractExclusionSets>;
4583
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
4584
+ get(id: Identifier, opts?: {
4585
+ fresh?: boolean;
4586
+ } | null): Promise<ContractExclusionSets>;
4490
4587
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
4491
4588
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4492
4589
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4540,7 +4637,9 @@ declare class ContractMilestonesResource extends BaseResource<ContractMilestone,
4540
4637
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4541
4638
  count(params?: ContractMilestonesResourceQueryParams): Promise<number>;
4542
4639
  /** 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>;
4640
+ get(parentId: Identifier, id: Identifier, opts?: {
4641
+ fresh?: boolean;
4642
+ } | null): Promise<ContractMilestone>;
4544
4643
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4545
4644
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4546
4645
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4582,7 +4681,9 @@ declare class ContractNotesResource extends BaseResource<ContractNote, ContractN
4582
4681
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4583
4682
  count(params?: ContractNotesResourceQueryParams): Promise<number>;
4584
4683
  /** 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>;
4684
+ get(parentId: Identifier, id: Identifier, opts?: {
4685
+ fresh?: boolean;
4686
+ } | null): Promise<ContractNote>;
4586
4687
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4587
4688
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4588
4689
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4624,7 +4725,9 @@ declare class ContractRatesResource extends BaseResource<ContractRate, ContractR
4624
4725
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4625
4726
  count(params?: ContractRatesResourceQueryParams): Promise<number>;
4626
4727
  /** 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>;
4728
+ get(parentId: Identifier, id: Identifier, opts?: {
4729
+ fresh?: boolean;
4730
+ } | null): Promise<ContractRate>;
4628
4731
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4629
4732
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4630
4733
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4666,7 +4769,9 @@ declare class ContractRetainersResource extends BaseResource<ContractRetainers,
4666
4769
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4667
4770
  count(params?: ContractRetainersResourceQueryParams): Promise<number>;
4668
4771
  /** 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>;
4772
+ get(parentId: Identifier, id: Identifier, opts?: {
4773
+ fresh?: boolean;
4774
+ } | null): Promise<ContractRetainers>;
4670
4775
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4671
4776
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4672
4777
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4708,7 +4813,9 @@ declare class ContractRoleCostsResource extends BaseResource<ContractRoleCosts,
4708
4813
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4709
4814
  count(params?: ContractRoleCostsResourceQueryParams): Promise<number>;
4710
4815
  /** 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>;
4816
+ get(parentId: Identifier, id: Identifier, opts?: {
4817
+ fresh?: boolean;
4818
+ } | null): Promise<ContractRoleCosts>;
4712
4819
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4713
4820
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4714
4821
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4808,7 +4915,9 @@ declare class ContractServiceBundlesResource extends BaseResource<ContractServic
4808
4915
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4809
4916
  count(params?: ContractServiceBundlesResourceQueryParams): Promise<number>;
4810
4917
  /** 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>;
4918
+ get(parentId: Identifier, id: Identifier, opts?: {
4919
+ fresh?: boolean;
4920
+ } | null): Promise<ContractServiceBundle>;
4812
4921
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4813
4922
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4814
4923
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4850,7 +4959,9 @@ declare class ContractServiceBundleUnitsResource extends BaseResource<ContractSe
4850
4959
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4851
4960
  count(params?: ContractServiceBundleUnitsResourceQueryParams): Promise<number>;
4852
4961
  /** 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>;
4962
+ get(parentId: Identifier, id: Identifier, opts?: {
4963
+ fresh?: boolean;
4964
+ } | null): Promise<ContractServiceBundleUnit>;
4854
4965
  /** Resolve a ContractServiceBundleUnit from a numeric id (or, where the vendor indexes a primary text field,
4855
4966
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
4856
4967
  * a bare value rejects with a config error (ids only);
@@ -4882,7 +4993,9 @@ declare class ContractServicesResource extends BaseResource<ContractService, Con
4882
4993
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4883
4994
  count(params?: ContractServicesResourceQueryParams): Promise<number>;
4884
4995
  /** 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>;
4996
+ get(parentId: Identifier, id: Identifier, opts?: {
4997
+ fresh?: boolean;
4998
+ } | null): Promise<ContractService>;
4886
4999
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4887
5000
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4888
5001
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4924,7 +5037,9 @@ declare class ContractServiceUnitsResource extends BaseResource<ContractServiceU
4924
5037
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4925
5038
  count(params?: ContractServiceUnitsResourceQueryParams): Promise<number>;
4926
5039
  /** 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>;
5040
+ get(parentId: Identifier, id: Identifier, opts?: {
5041
+ fresh?: boolean;
5042
+ } | null): Promise<ContractServiceUnit>;
4928
5043
  /** Resolve a ContractServiceUnit from a numeric id (or, where the vendor indexes a primary text field,
4929
5044
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
4930
5045
  * a bare value rejects with a config error (ids only);
@@ -5230,8 +5345,10 @@ declare class ContractsResource extends BaseResource<Contract, ContractCreate, C
5230
5345
  queryAll(params?: ContractsResourceQueryParams): Promise<Contract[]>;
5231
5346
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5232
5347
  count(params?: ContractsResourceQueryParams): Promise<number>;
5233
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5234
- get(id: Identifier): Promise<Contract>;
5348
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5349
+ get(id: Identifier, opts?: {
5350
+ fresh?: boolean;
5351
+ } | null): Promise<Contract>;
5235
5352
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5236
5353
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5237
5354
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5286,7 +5403,9 @@ declare class ContractTicketPurchasesResource extends BaseResource<ContractTicke
5286
5403
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5287
5404
  count(params?: ContractTicketPurchasesResourceQueryParams): Promise<number>;
5288
5405
  /** 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>;
5406
+ get(parentId: Identifier, id: Identifier, opts?: {
5407
+ fresh?: boolean;
5408
+ } | null): Promise<ContractTicketPurchases>;
5290
5409
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5291
5410
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5292
5411
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5325,8 +5444,10 @@ declare class CountriesResource extends BaseResource<Country, CountryCreate, Cou
5325
5444
  queryAll(params?: CountriesResourceQueryParams): Promise<Country[]>;
5326
5445
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5327
5446
  count(params?: CountriesResourceQueryParams): Promise<number>;
5328
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5329
- get(id: Identifier): Promise<Country>;
5447
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5448
+ get(id: Identifier, opts?: {
5449
+ fresh?: boolean;
5450
+ } | null): Promise<Country>;
5330
5451
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
5331
5452
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
5332
5453
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -5369,8 +5490,10 @@ declare class CurrenciesResource extends BaseResource<Currency, CurrencyCreate,
5369
5490
  queryAll(params?: CurrenciesResourceQueryParams): Promise<Currency[]>;
5370
5491
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5371
5492
  count(params?: CurrenciesResourceQueryParams): Promise<number>;
5372
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5373
- get(id: Identifier): Promise<Currency>;
5493
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5494
+ get(id: Identifier, opts?: {
5495
+ fresh?: boolean;
5496
+ } | null): Promise<Currency>;
5374
5497
  /** Resolve a Currency from a numeric id (or, where the vendor indexes a primary text field,
5375
5498
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
5376
5499
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -5403,8 +5526,10 @@ declare class DepartmentsResource extends BaseResource<Department, DepartmentCre
5403
5526
  queryAll(params?: DepartmentsResourceQueryParams): Promise<Department[]>;
5404
5527
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5405
5528
  count(params?: DepartmentsResourceQueryParams): Promise<number>;
5406
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5407
- get(id: Identifier): Promise<Department>;
5529
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5530
+ get(id: Identifier, opts?: {
5531
+ fresh?: boolean;
5532
+ } | null): Promise<Department>;
5408
5533
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5409
5534
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5410
5535
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5452,8 +5577,10 @@ declare class DomainRegistrarsResource extends BaseResource<DomainRegistrar, Dom
5452
5577
  queryAll(params?: DomainRegistrarsResourceQueryParams): Promise<DomainRegistrar[]>;
5453
5578
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5454
5579
  count(params?: DomainRegistrarsResourceQueryParams): Promise<number>;
5455
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5456
- get(id: Identifier): Promise<DomainRegistrar>;
5580
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5581
+ get(id: Identifier, opts?: {
5582
+ fresh?: boolean;
5583
+ } | null): Promise<DomainRegistrar>;
5457
5584
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5458
5585
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5459
5586
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5519,7 +5646,9 @@ declare class ExpenseItemAttachmentsResource extends BaseResource<ExpenseItemAtt
5519
5646
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5520
5647
  count(params?: ExpenseItemAttachmentsResourceQueryParams): Promise<number>;
5521
5648
  /** 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>;
5649
+ get(parentId: Identifier, id: Identifier, opts?: {
5650
+ fresh?: boolean;
5651
+ } | null): Promise<ExpenseItemAttachment>;
5523
5652
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5524
5653
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5525
5654
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5560,8 +5689,10 @@ declare class ExpenseItemsResource extends BaseResource<ExpenseItem, ExpenseItem
5560
5689
  queryAll(params?: ExpenseItemsResourceQueryParams): Promise<ExpenseItem[]>;
5561
5690
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5562
5691
  count(params?: ExpenseItemsResourceQueryParams): Promise<number>;
5563
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5564
- get(id: Identifier): Promise<ExpenseItem>;
5692
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5693
+ get(id: Identifier, opts?: {
5694
+ fresh?: boolean;
5695
+ } | null): Promise<ExpenseItem>;
5565
5696
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5566
5697
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5567
5698
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5600,8 +5731,10 @@ declare class ExpenseReportsResource extends BaseResource<ExpenseReport, Expense
5600
5731
  queryAll(params?: ExpenseReportsResourceQueryParams): Promise<ExpenseReport[]>;
5601
5732
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5602
5733
  count(params?: ExpenseReportsResourceQueryParams): Promise<number>;
5603
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5604
- get(id: Identifier): Promise<ExpenseReport>;
5734
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5735
+ get(id: Identifier, opts?: {
5736
+ fresh?: boolean;
5737
+ } | null): Promise<ExpenseReport>;
5605
5738
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5606
5739
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5607
5740
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5649,8 +5782,10 @@ declare class HolidaySetsResource extends BaseResource<HolidaySet, HolidaySetCre
5649
5782
  queryAll(params?: HolidaySetsResourceQueryParams): Promise<HolidaySet[]>;
5650
5783
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5651
5784
  count(params?: HolidaySetsResourceQueryParams): Promise<number>;
5652
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5653
- get(id: Identifier): Promise<HolidaySet>;
5785
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5786
+ get(id: Identifier, opts?: {
5787
+ fresh?: boolean;
5788
+ } | null): Promise<HolidaySet>;
5654
5789
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5655
5790
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5656
5791
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5700,7 +5835,9 @@ declare class HolidaysResource extends BaseResource<Holiday, HolidayCreate, Holi
5700
5835
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5701
5836
  count(params?: HolidaysResourceQueryParams): Promise<number>;
5702
5837
  /** 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>;
5838
+ get(parentId: Identifier, id: Identifier, opts?: {
5839
+ fresh?: boolean;
5840
+ } | null): Promise<Holiday>;
5704
5841
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5705
5842
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5706
5843
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5742,8 +5879,10 @@ declare class InventoryProductsResource extends BaseResource<InventoryProduct, I
5742
5879
  queryAll(params?: InventoryProductsResourceQueryParams): Promise<InventoryProduct[]>;
5743
5880
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5744
5881
  count(params?: InventoryProductsResourceQueryParams): Promise<number>;
5745
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5746
- get(id: Identifier): Promise<InventoryProduct>;
5882
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5883
+ get(id: Identifier, opts?: {
5884
+ fresh?: boolean;
5885
+ } | null): Promise<InventoryProduct>;
5747
5886
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5748
5887
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5749
5888
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5796,8 +5935,10 @@ declare class InvoicesResource extends BaseResource<Invoice, InvoiceCreate, Invo
5796
5935
  queryAll(params?: InvoicesResourceQueryParams): Promise<Invoice[]>;
5797
5936
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5798
5937
  count(params?: InvoicesResourceQueryParams): Promise<number>;
5799
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5800
- get(id: Identifier): Promise<Invoice>;
5938
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
5939
+ get(id: Identifier, opts?: {
5940
+ fresh?: boolean;
5941
+ } | null): Promise<Invoice>;
5801
5942
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
5802
5943
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
5803
5944
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -5866,8 +6007,10 @@ declare class InvoiceTemplatesResource extends BaseResource<InvoiceTemplate, Inv
5866
6007
  queryAll(params?: InvoiceTemplatesResourceQueryParams): Promise<InvoiceTemplate[]>;
5867
6008
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5868
6009
  count(params?: InvoiceTemplatesResourceQueryParams): Promise<number>;
5869
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5870
- get(id: Identifier): Promise<InvoiceTemplate>;
6010
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6011
+ get(id: Identifier, opts?: {
6012
+ fresh?: boolean;
6013
+ } | null): Promise<InvoiceTemplate>;
5871
6014
  }
5872
6015
 
5873
6016
  /**
@@ -5901,8 +6044,10 @@ declare class NotificationHistoryResource extends BaseResource<NotificationHisto
5901
6044
  queryAll(params?: NotificationHistoryResourceQueryParams): Promise<NotificationHistory[]>;
5902
6045
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5903
6046
  count(params?: NotificationHistoryResourceQueryParams): Promise<number>;
5904
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5905
- get(id: Identifier): Promise<NotificationHistory>;
6047
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6048
+ get(id: Identifier, opts?: {
6049
+ fresh?: boolean;
6050
+ } | null): Promise<NotificationHistory>;
5906
6051
  /** Resolve a NotificationHistory from a numeric id (or, where the vendor indexes a primary text field,
5907
6052
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
5908
6053
  * a bare value rejects with a config error (ids only);
@@ -5931,8 +6076,10 @@ declare class OpportunitiesResource extends BaseResource<Opportunity, Opportunit
5931
6076
  queryAll(params?: OpportunitiesResourceQueryParams): Promise<Opportunity[]>;
5932
6077
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5933
6078
  count(params?: OpportunitiesResourceQueryParams): Promise<number>;
5934
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5935
- get(id: Identifier): Promise<Opportunity>;
6079
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6080
+ get(id: Identifier, opts?: {
6081
+ fresh?: boolean;
6082
+ } | null): Promise<Opportunity>;
5936
6083
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5937
6084
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5938
6085
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5979,7 +6126,9 @@ declare class OpportunityAttachmentsResource extends BaseResource<OpportunityAtt
5979
6126
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5980
6127
  count(params?: OpportunityAttachmentsResourceQueryParams): Promise<number>;
5981
6128
  /** 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>;
6129
+ get(parentId: Identifier, id: Identifier, opts?: {
6130
+ fresh?: boolean;
6131
+ } | null): Promise<OpportunityAttachment>;
5983
6132
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5984
6133
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5985
6134
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6018,8 +6167,10 @@ declare class OpportunityCategoriesResource extends BaseResource<OpportunityCate
6018
6167
  queryAll(params?: OpportunityCategoriesResourceQueryParams): Promise<OpportunityCategory[]>;
6019
6168
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6020
6169
  count(params?: OpportunityCategoriesResourceQueryParams): Promise<number>;
6021
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6022
- get(id: Identifier): Promise<OpportunityCategory>;
6170
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6171
+ get(id: Identifier, opts?: {
6172
+ fresh?: boolean;
6173
+ } | null): Promise<OpportunityCategory>;
6023
6174
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
6024
6175
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
6025
6176
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -6062,8 +6213,10 @@ declare class OrganizationalLevel1sResource extends BaseResource<OrganizationalL
6062
6213
  queryAll(params?: OrganizationalLevel1sResourceQueryParams): Promise<OrganizationalLevel1[]>;
6063
6214
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6064
6215
  count(params?: OrganizationalLevel1sResourceQueryParams): Promise<number>;
6065
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6066
- get(id: Identifier): Promise<OrganizationalLevel1>;
6216
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6217
+ get(id: Identifier, opts?: {
6218
+ fresh?: boolean;
6219
+ } | null): Promise<OrganizationalLevel1>;
6067
6220
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6068
6221
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6069
6222
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6097,8 +6250,10 @@ declare class OrganizationalLevel2sResource extends BaseResource<OrganizationalL
6097
6250
  queryAll(params?: OrganizationalLevel2sResourceQueryParams): Promise<OrganizationalLevel2[]>;
6098
6251
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6099
6252
  count(params?: OrganizationalLevel2sResourceQueryParams): Promise<number>;
6100
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6101
- get(id: Identifier): Promise<OrganizationalLevel2>;
6253
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6254
+ get(id: Identifier, opts?: {
6255
+ fresh?: boolean;
6256
+ } | null): Promise<OrganizationalLevel2>;
6102
6257
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6103
6258
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6104
6259
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6132,8 +6287,10 @@ declare class OrganizationalLevelAssociationsResource extends BaseResource<Organ
6132
6287
  queryAll(params?: OrganizationalLevelAssociationsResourceQueryParams): Promise<OrganizationalLevelAssociation[]>;
6133
6288
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6134
6289
  count(params?: OrganizationalLevelAssociationsResourceQueryParams): Promise<number>;
6135
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6136
- get(id: Identifier): Promise<OrganizationalLevelAssociation>;
6290
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6291
+ get(id: Identifier, opts?: {
6292
+ fresh?: boolean;
6293
+ } | null): Promise<OrganizationalLevelAssociation>;
6137
6294
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6138
6295
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6139
6296
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6170,7 +6327,9 @@ declare class PhasesResource extends BaseResource<Phase, PhaseCreate, PhaseUpdat
6170
6327
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6171
6328
  count(params?: PhasesResourceQueryParams): Promise<number>;
6172
6329
  /** 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>;
6330
+ get(parentId: Identifier, id: Identifier, opts?: {
6331
+ fresh?: boolean;
6332
+ } | null): Promise<Phase>;
6174
6333
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6175
6334
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6176
6335
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6209,8 +6368,10 @@ declare class ProductsResource extends BaseResource<Product, ProductCreate, Prod
6209
6368
  queryAll(params?: ProductsResourceQueryParams): Promise<Product[]>;
6210
6369
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6211
6370
  count(params?: ProductsResourceQueryParams): Promise<number>;
6212
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6213
- get(id: Identifier): Promise<Product>;
6371
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6372
+ get(id: Identifier, opts?: {
6373
+ fresh?: boolean;
6374
+ } | null): Promise<Product>;
6214
6375
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6215
6376
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6216
6377
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6261,7 +6422,9 @@ declare class ProductVendorsResource extends BaseResource<ProductVendors, Produc
6261
6422
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6262
6423
  count(params?: ProductVendorsResourceQueryParams): Promise<number>;
6263
6424
  /** 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>;
6425
+ get(parentId: Identifier, id: Identifier, opts?: {
6426
+ fresh?: boolean;
6427
+ } | null): Promise<ProductVendors>;
6265
6428
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6266
6429
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6267
6430
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6303,7 +6466,9 @@ declare class ProjectChargesResource extends BaseResource<ProjectCharge, Project
6303
6466
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6304
6467
  count(params?: ProjectChargesResourceQueryParams): Promise<number>;
6305
6468
  /** 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>;
6469
+ get(parentId: Identifier, id: Identifier, opts?: {
6470
+ fresh?: boolean;
6471
+ } | null): Promise<ProjectCharge>;
6307
6472
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6308
6473
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6309
6474
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6352,7 +6517,9 @@ declare class ProjectNotesResource extends BaseResource<ProjectNote, ProjectNote
6352
6517
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6353
6518
  count(params?: ProjectNotesResourceQueryParams): Promise<number>;
6354
6519
  /** 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>;
6520
+ get(parentId: Identifier, id: Identifier, opts?: {
6521
+ fresh?: boolean;
6522
+ } | null): Promise<ProjectNote>;
6356
6523
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6357
6524
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6358
6525
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6391,8 +6558,10 @@ declare class ProjectsResource extends BaseResource<Project, ProjectCreate, Proj
6391
6558
  queryAll(params?: ProjectsResourceQueryParams): Promise<Project[]>;
6392
6559
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6393
6560
  count(params?: ProjectsResourceQueryParams): Promise<number>;
6394
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6395
- get(id: Identifier): Promise<Project>;
6561
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6562
+ get(id: Identifier, opts?: {
6563
+ fresh?: boolean;
6564
+ } | null): Promise<Project>;
6396
6565
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6397
6566
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6398
6567
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6446,8 +6615,10 @@ declare class PurchaseApprovalsResource extends BaseResource<PurchaseApprovals,
6446
6615
  queryAll(params?: PurchaseApprovalsResourceQueryParams): Promise<PurchaseApprovals[]>;
6447
6616
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6448
6617
  count(params?: PurchaseApprovalsResourceQueryParams): Promise<number>;
6449
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6450
- get(id: Identifier): Promise<PurchaseApprovals>;
6618
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6619
+ get(id: Identifier, opts?: {
6620
+ fresh?: boolean;
6621
+ } | null): Promise<PurchaseApprovals>;
6451
6622
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
6452
6623
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
6453
6624
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -6489,7 +6660,9 @@ declare class PurchaseOrderItemReceivingResource extends BaseResource<PurchaseOr
6489
6660
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6490
6661
  count(params?: PurchaseOrderItemReceivingResourceQueryParams): Promise<number>;
6491
6662
  /** 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>;
6663
+ get(parentId: Identifier, id: Identifier, opts?: {
6664
+ fresh?: boolean;
6665
+ } | null): Promise<PurchaseOrderItemReceiving>;
6493
6666
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6494
6667
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6495
6668
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6526,7 +6699,9 @@ declare class PurchaseOrderItemsResource extends BaseResource<PurchaseOrderItems
6526
6699
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6527
6700
  count(params?: PurchaseOrderItemsResourceQueryParams): Promise<number>;
6528
6701
  /** 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>;
6702
+ get(parentId: Identifier, id: Identifier, opts?: {
6703
+ fresh?: boolean;
6704
+ } | null): Promise<PurchaseOrderItems>;
6530
6705
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6531
6706
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6532
6707
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6565,8 +6740,10 @@ declare class PurchaseOrdersResource extends BaseResource<PurchaseOrders, Purcha
6565
6740
  queryAll(params?: PurchaseOrdersResourceQueryParams): Promise<PurchaseOrders[]>;
6566
6741
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6567
6742
  count(params?: PurchaseOrdersResourceQueryParams): Promise<number>;
6568
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6569
- get(id: Identifier): Promise<PurchaseOrders>;
6743
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6744
+ get(id: Identifier, opts?: {
6745
+ fresh?: boolean;
6746
+ } | null): Promise<PurchaseOrders>;
6570
6747
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6571
6748
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6572
6749
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6613,7 +6790,9 @@ declare class QuoteItemsResource extends BaseResource<QuoteItem, QuoteItemCreate
6613
6790
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6614
6791
  count(params?: QuoteItemsResourceQueryParams): Promise<number>;
6615
6792
  /** 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>;
6793
+ get(parentId: Identifier, id: Identifier, opts?: {
6794
+ fresh?: boolean;
6795
+ } | null): Promise<QuoteItem>;
6617
6796
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6618
6797
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6619
6798
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6661,8 +6840,10 @@ declare class QuoteLocationsResource extends BaseResource<QuoteLocation, QuoteLo
6661
6840
  queryAll(params?: QuoteLocationsResourceQueryParams): Promise<QuoteLocation[]>;
6662
6841
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6663
6842
  count(params?: QuoteLocationsResourceQueryParams): Promise<number>;
6664
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6665
- get(id: Identifier): Promise<QuoteLocation>;
6843
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6844
+ get(id: Identifier, opts?: {
6845
+ fresh?: boolean;
6846
+ } | null): Promise<QuoteLocation>;
6666
6847
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6667
6848
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6668
6849
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6706,8 +6887,10 @@ declare class QuotesResource extends BaseResource<Quote, QuoteCreate, QuoteUpdat
6706
6887
  queryAll(params?: QuotesResourceQueryParams): Promise<Quote[]>;
6707
6888
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6708
6889
  count(params?: QuotesResourceQueryParams): Promise<number>;
6709
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6710
- get(id: Identifier): Promise<Quote>;
6890
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6891
+ get(id: Identifier, opts?: {
6892
+ fresh?: boolean;
6893
+ } | null): Promise<Quote>;
6711
6894
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6712
6895
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6713
6896
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6755,8 +6938,10 @@ declare class QuoteTemplatesResource extends BaseResource<QuoteTemplate, QuoteTe
6755
6938
  queryAll(params?: QuoteTemplatesResourceQueryParams): Promise<QuoteTemplate[]>;
6756
6939
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6757
6940
  count(params?: QuoteTemplatesResourceQueryParams): Promise<number>;
6758
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6759
- get(id: Identifier): Promise<QuoteTemplate>;
6941
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6942
+ get(id: Identifier, opts?: {
6943
+ fresh?: boolean;
6944
+ } | null): Promise<QuoteTemplate>;
6760
6945
  /** Resolve a QuoteTemplate from a numeric id (or, where the vendor indexes a primary text field,
6761
6946
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
6762
6947
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -6792,7 +6977,9 @@ declare class ResourceRoleQueuesResource extends BaseResource<ResourceRoleQueue,
6792
6977
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6793
6978
  count(params?: ResourceRoleQueuesResourceQueryParams): Promise<number>;
6794
6979
  /** 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>;
6980
+ get(parentId: Identifier, id: Identifier, opts?: {
6981
+ fresh?: boolean;
6982
+ } | null): Promise<ResourceRoleQueue>;
6796
6983
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6797
6984
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6798
6985
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6834,7 +7021,9 @@ declare class ResourceRolesResource extends BaseResource<ResourceRole, ResourceR
6834
7021
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6835
7022
  count(params?: ResourceRolesResourceQueryParams): Promise<number>;
6836
7023
  /** 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>;
7024
+ get(parentId: Identifier, id: Identifier, opts?: {
7025
+ fresh?: boolean;
7026
+ } | null): Promise<ResourceRole>;
6838
7027
  /** Resolve a ResourceRole from a numeric id (or, where the vendor indexes a primary text field,
6839
7028
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
6840
7029
  * a bare value rejects with a config error (ids only);
@@ -6866,7 +7055,9 @@ declare class ResourceSkillsResource extends BaseResource<ResourceSkill, Resourc
6866
7055
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6867
7056
  count(params?: ResourceSkillsResourceQueryParams): Promise<number>;
6868
7057
  /** 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>;
7058
+ get(parentId: Identifier, id: Identifier, opts?: {
7059
+ fresh?: boolean;
7060
+ } | null): Promise<ResourceSkill>;
6870
7061
  /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
6871
7062
  * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
6872
7063
  * the pinned envelope with the best-effort diff; a caller-supplied lastModifiedDate that
@@ -6935,13 +7126,10 @@ declare class ResourcesResource extends BaseResource<Resource, ResourceCreate, R
6935
7126
  queryAll(params?: ResourcesResourceQueryParams): Promise<Resource[]>;
6936
7127
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6937
7128
  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. */
7129
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
6942
7130
  get(id: Identifier, opts?: {
6943
7131
  fresh?: boolean;
6944
- }): Promise<Resource>;
7132
+ } | null): Promise<Resource>;
6945
7133
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
6946
7134
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
6947
7135
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -7022,7 +7210,9 @@ declare class ResourceTimeOffApproversResource extends BaseResource<ResourceTime
7022
7210
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7023
7211
  count(params?: ResourceTimeOffApproversResourceQueryParams): Promise<number>;
7024
7212
  /** 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>;
7213
+ get(parentId: Identifier, id: Identifier, opts?: {
7214
+ fresh?: boolean;
7215
+ } | null): Promise<ResourceTimeOffApprover>;
7026
7216
  /** Resolve a ResourceTimeOffApprover from a numeric id (or, where the vendor indexes a primary text field,
7027
7217
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7028
7218
  * a bare value rejects with a config error (ids only);
@@ -7048,7 +7238,9 @@ type ResourceTimeOffBalancesResourceQueryParams = QueryParams;
7048
7238
  declare class ResourceTimeOffBalancesResource extends BaseResource<ResourceTimeOffBalance, ResourceTimeOffBalanceCreate, ResourceTimeOffBalanceUpdate> {
7049
7239
  constructor(http: HttpClient, pageSize: number);
7050
7240
  /** 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>;
7241
+ get(parentId: Identifier, id: Identifier, opts?: {
7242
+ fresh?: boolean;
7243
+ } | null): Promise<ResourceTimeOffBalance>;
7052
7244
  /** Resolve a ResourceTimeOffBalance from a numeric id (or, where the vendor indexes a primary text field,
7053
7245
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7054
7246
  * a bare value rejects with a config error (ids only);
@@ -7081,8 +7273,10 @@ declare class RolesResource extends BaseResource<Role, RoleCreate, RoleUpdate> {
7081
7273
  queryAll(params?: RolesResourceQueryParams): Promise<Role[]>;
7082
7274
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7083
7275
  count(params?: RolesResourceQueryParams): Promise<number>;
7084
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7085
- get(id: Identifier): Promise<Role>;
7276
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7277
+ get(id: Identifier, opts?: {
7278
+ fresh?: boolean;
7279
+ } | null): Promise<Role>;
7086
7280
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7087
7281
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7088
7282
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7130,8 +7324,10 @@ declare class SalesOrdersResource extends BaseResource<SalesOrder, SalesOrderCre
7130
7324
  queryAll(params?: SalesOrdersResourceQueryParams): Promise<SalesOrder[]>;
7131
7325
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7132
7326
  count(params?: SalesOrdersResourceQueryParams): Promise<number>;
7133
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7134
- get(id: Identifier): Promise<SalesOrder>;
7327
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7328
+ get(id: Identifier, opts?: {
7329
+ fresh?: boolean;
7330
+ } | null): Promise<SalesOrder>;
7135
7331
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
7136
7332
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
7137
7333
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -7160,8 +7356,10 @@ declare class ServiceCallsResource extends BaseResource<ServiceCall, ServiceCall
7160
7356
  queryAll(params?: ServiceCallsResourceQueryParams): Promise<ServiceCall[]>;
7161
7357
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7162
7358
  count(params?: ServiceCallsResourceQueryParams): Promise<number>;
7163
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7164
- get(id: Identifier): Promise<ServiceCall>;
7359
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7360
+ get(id: Identifier, opts?: {
7361
+ fresh?: boolean;
7362
+ } | null): Promise<ServiceCall>;
7165
7363
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7166
7364
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7167
7365
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7211,7 +7409,9 @@ declare class ServiceCallTaskResourcesResource extends BaseResource<ServiceCallT
7211
7409
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7212
7410
  count(params?: ServiceCallTaskResourcesResourceQueryParams): Promise<number>;
7213
7411
  /** 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>;
7412
+ get(parentId: Identifier, id: Identifier, opts?: {
7413
+ fresh?: boolean;
7414
+ } | null): Promise<ServiceCallTaskResource>;
7215
7415
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7216
7416
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7217
7417
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7251,7 +7451,9 @@ declare class ServiceCallTasksResource extends BaseResource<ServiceCallTask, Ser
7251
7451
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7252
7452
  count(params?: ServiceCallTasksResourceQueryParams): Promise<number>;
7253
7453
  /** 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>;
7454
+ get(parentId: Identifier, id: Identifier, opts?: {
7455
+ fresh?: boolean;
7456
+ } | null): Promise<ServiceCallTask>;
7255
7457
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7256
7458
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7257
7459
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7291,7 +7493,9 @@ declare class ServiceCallTicketResourcesResource extends BaseResource<ServiceCal
7291
7493
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7292
7494
  count(params?: ServiceCallTicketResourcesResourceQueryParams): Promise<number>;
7293
7495
  /** 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>;
7496
+ get(parentId: Identifier, id: Identifier, opts?: {
7497
+ fresh?: boolean;
7498
+ } | null): Promise<ServiceCallTicketResource>;
7295
7499
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7296
7500
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7297
7501
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7331,7 +7535,9 @@ declare class ServiceCallTicketsResource extends BaseResource<ServiceCallTicket,
7331
7535
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7332
7536
  count(params?: ServiceCallTicketsResourceQueryParams): Promise<number>;
7333
7537
  /** 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>;
7538
+ get(parentId: Identifier, id: Identifier, opts?: {
7539
+ fresh?: boolean;
7540
+ } | null): Promise<ServiceCallTicket>;
7335
7541
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7336
7542
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7337
7543
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7368,8 +7574,10 @@ declare class ServiceLevelAgreementResultsResource extends BaseResource<ServiceL
7368
7574
  queryAll(params?: ServiceLevelAgreementResultsResourceQueryParams): Promise<ServiceLevelAgreementResults[]>;
7369
7575
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7370
7576
  count(params?: ServiceLevelAgreementResultsResourceQueryParams): Promise<number>;
7371
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7372
- get(id: Identifier): Promise<ServiceLevelAgreementResults>;
7577
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7578
+ get(id: Identifier, opts?: {
7579
+ fresh?: boolean;
7580
+ } | null): Promise<ServiceLevelAgreementResults>;
7373
7581
  /** Resolve a ServiceLevelAgreementResults from a numeric id (or, where the vendor indexes a primary text field,
7374
7582
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7375
7583
  * a bare value rejects with a config error (ids only);
@@ -7398,8 +7606,10 @@ declare class ServicesResource extends BaseResource<Service, ServiceCreate, Serv
7398
7606
  queryAll(params?: ServicesResourceQueryParams): Promise<Service[]>;
7399
7607
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7400
7608
  count(params?: ServicesResourceQueryParams): Promise<number>;
7401
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7402
- get(id: Identifier): Promise<Service>;
7609
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7610
+ get(id: Identifier, opts?: {
7611
+ fresh?: boolean;
7612
+ } | null): Promise<Service>;
7403
7613
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7404
7614
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7405
7615
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7447,8 +7657,10 @@ declare class SkillsResource extends BaseResource<Skill, SkillCreate, SkillUpdat
7447
7657
  queryAll(params?: SkillsResourceQueryParams): Promise<Skill[]>;
7448
7658
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7449
7659
  count(params?: SkillsResourceQueryParams): Promise<number>;
7450
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7451
- get(id: Identifier): Promise<Skill>;
7660
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7661
+ get(id: Identifier, opts?: {
7662
+ fresh?: boolean;
7663
+ } | null): Promise<Skill>;
7452
7664
  /** Resolve a Skill from a numeric id (or, where the vendor indexes a primary text field,
7453
7665
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
7454
7666
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -7481,8 +7693,10 @@ declare class SubscriptionPeriodsResource extends BaseResource<SubscriptionPerio
7481
7693
  queryAll(params?: SubscriptionPeriodsResourceQueryParams): Promise<SubscriptionPeriod[]>;
7482
7694
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7483
7695
  count(params?: SubscriptionPeriodsResourceQueryParams): Promise<number>;
7484
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7485
- get(id: Identifier): Promise<SubscriptionPeriod>;
7696
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7697
+ get(id: Identifier, opts?: {
7698
+ fresh?: boolean;
7699
+ } | null): Promise<SubscriptionPeriod>;
7486
7700
  /** Resolve a SubscriptionPeriod from a numeric id (or, where the vendor indexes a primary text field,
7487
7701
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7488
7702
  * a bare value rejects with a config error (ids only);
@@ -7511,8 +7725,10 @@ declare class SubscriptionsResource extends BaseResource<Subscription, Subscript
7511
7725
  queryAll(params?: SubscriptionsResourceQueryParams): Promise<Subscription[]>;
7512
7726
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7513
7727
  count(params?: SubscriptionsResourceQueryParams): Promise<number>;
7514
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7515
- get(id: Identifier): Promise<Subscription>;
7728
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7729
+ get(id: Identifier, opts?: {
7730
+ fresh?: boolean;
7731
+ } | null): Promise<Subscription>;
7516
7732
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7517
7733
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7518
7734
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7559,8 +7775,10 @@ declare class SurveyResultsResource extends BaseResource<SurveyResults, SurveyRe
7559
7775
  queryAll(params?: SurveyResultsResourceQueryParams): Promise<SurveyResults[]>;
7560
7776
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7561
7777
  count(params?: SurveyResultsResourceQueryParams): Promise<number>;
7562
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7563
- get(id: Identifier): Promise<SurveyResults>;
7778
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7779
+ get(id: Identifier, opts?: {
7780
+ fresh?: boolean;
7781
+ } | null): Promise<SurveyResults>;
7564
7782
  /** Resolve a SurveyResults from a numeric id (or, where the vendor indexes a primary text field,
7565
7783
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7566
7784
  * a bare value rejects with a config error (ids only);
@@ -7589,8 +7807,10 @@ declare class SurveysResource extends BaseResource<Survey, SurveyCreate, SurveyU
7589
7807
  queryAll(params?: SurveysResourceQueryParams): Promise<Survey[]>;
7590
7808
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7591
7809
  count(params?: SurveysResourceQueryParams): Promise<number>;
7592
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7593
- get(id: Identifier): Promise<Survey>;
7810
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7811
+ get(id: Identifier, opts?: {
7812
+ fresh?: boolean;
7813
+ } | null): Promise<Survey>;
7594
7814
  /** Resolve a Survey from a numeric id (or, where the vendor indexes a primary text field,
7595
7815
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
7596
7816
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -7626,7 +7846,9 @@ declare class TagAliasesResource extends BaseResource<TagAlias, TagAliasCreate,
7626
7846
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7627
7847
  count(params?: TagAliasesResourceQueryParams): Promise<number>;
7628
7848
  /** 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>;
7849
+ get(parentId: Identifier, id: Identifier, opts?: {
7850
+ fresh?: boolean;
7851
+ } | null): Promise<TagAlias>;
7630
7852
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7631
7853
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7632
7854
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7663,8 +7885,10 @@ declare class TagGroupsResource extends BaseResource<TagGroup, TagGroupCreate, T
7663
7885
  queryAll(params?: TagGroupsResourceQueryParams): Promise<TagGroup[]>;
7664
7886
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7665
7887
  count(params?: TagGroupsResourceQueryParams): Promise<number>;
7666
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7667
- get(id: Identifier): Promise<TagGroup>;
7888
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7889
+ get(id: Identifier, opts?: {
7890
+ fresh?: boolean;
7891
+ } | null): Promise<TagGroup>;
7668
7892
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7669
7893
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7670
7894
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7711,8 +7935,10 @@ declare class TagsResource extends BaseResource<Tag, TagCreate, TagUpdate> {
7711
7935
  queryAll(params?: TagsResourceQueryParams): Promise<Tag[]>;
7712
7936
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7713
7937
  count(params?: TagsResourceQueryParams): Promise<number>;
7714
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7715
- get(id: Identifier): Promise<Tag>;
7938
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
7939
+ get(id: Identifier, opts?: {
7940
+ fresh?: boolean;
7941
+ } | null): Promise<Tag>;
7716
7942
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7717
7943
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7718
7944
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7762,7 +7988,9 @@ declare class TaskSecondaryResourcesResource extends BaseResource<TaskSecondaryR
7762
7988
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7763
7989
  count(params?: TaskSecondaryResourcesResourceQueryParams): Promise<number>;
7764
7990
  /** 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>;
7991
+ get(parentId: Identifier, id: Identifier, opts?: {
7992
+ fresh?: boolean;
7993
+ } | null): Promise<TaskSecondaryResource>;
7766
7994
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7767
7995
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7768
7996
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7802,7 +8030,9 @@ declare class TasksResource extends BaseResource<Task, TaskCreate, TaskUpdate> {
7802
8030
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7803
8031
  count(params?: TasksResourceQueryParams): Promise<number>;
7804
8032
  /** 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>;
8033
+ get(parentId: Identifier, id: Identifier, opts?: {
8034
+ fresh?: boolean;
8035
+ } | null): Promise<Task>;
7806
8036
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7807
8037
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7808
8038
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7845,8 +8075,10 @@ declare class TaxRegionsResource extends BaseResource<TaxRegion, TaxRegionCreate
7845
8075
  queryAll(params?: TaxRegionsResourceQueryParams): Promise<TaxRegion[]>;
7846
8076
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7847
8077
  count(params?: TaxRegionsResourceQueryParams): Promise<number>;
7848
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7849
- get(id: Identifier): Promise<TaxRegion>;
8078
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
8079
+ get(id: Identifier, opts?: {
8080
+ fresh?: boolean;
8081
+ } | null): Promise<TaxRegion>;
7850
8082
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7851
8083
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7852
8084
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7898,7 +8130,9 @@ declare class TicketAdditionalConfigurationItemsResource extends BaseResource<Ti
7898
8130
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7899
8131
  count(params?: TicketAdditionalConfigurationItemsResourceQueryParams): Promise<number>;
7900
8132
  /** 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>;
8133
+ get(parentId: Identifier, id: Identifier, opts?: {
8134
+ fresh?: boolean;
8135
+ } | null): Promise<TicketAdditionalConfigurationItem>;
7902
8136
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7903
8137
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7904
8138
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7938,7 +8172,9 @@ declare class TicketAdditionalContactsResource extends BaseResource<TicketAdditi
7938
8172
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7939
8173
  count(params?: TicketAdditionalContactsResourceQueryParams): Promise<number>;
7940
8174
  /** 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>;
8175
+ get(parentId: Identifier, id: Identifier, opts?: {
8176
+ fresh?: boolean;
8177
+ } | null): Promise<TicketAdditionalContact>;
7942
8178
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7943
8179
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7944
8180
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7978,7 +8214,9 @@ declare class TicketAttachmentsResource extends BaseResource<TicketAttachment, T
7978
8214
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7979
8215
  count(params?: TicketAttachmentsResourceQueryParams): Promise<number>;
7980
8216
  /** 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>;
8217
+ get(parentId: Identifier, id: Identifier, opts?: {
8218
+ fresh?: boolean;
8219
+ } | null): Promise<TicketAttachment>;
7982
8220
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7983
8221
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7984
8222
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8017,8 +8255,10 @@ declare class TicketCategoriesResource extends BaseResource<TicketCategory, Tick
8017
8255
  queryAll(params?: TicketCategoriesResourceQueryParams): Promise<TicketCategory[]>;
8018
8256
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8019
8257
  count(params?: TicketCategoriesResourceQueryParams): Promise<number>;
8020
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8021
- get(id: Identifier): Promise<TicketCategory>;
8258
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
8259
+ get(id: Identifier, opts?: {
8260
+ fresh?: boolean;
8261
+ } | null): Promise<TicketCategory>;
8022
8262
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
8023
8263
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
8024
8264
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -8064,7 +8304,9 @@ declare class TicketCategoryFieldDefaultsResource extends BaseResource<TicketCat
8064
8304
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8065
8305
  count(params?: TicketCategoryFieldDefaultsResourceQueryParams): Promise<number>;
8066
8306
  /** 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>;
8307
+ get(parentId: Identifier, id: Identifier, opts?: {
8308
+ fresh?: boolean;
8309
+ } | null): Promise<TicketCategoryFieldDefault>;
8068
8310
  /** Resolve a TicketCategoryFieldDefault from a numeric id (or, where the vendor indexes a primary text field,
8069
8311
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
8070
8312
  * a bare value rejects with a config error (ids only);
@@ -8096,7 +8338,9 @@ declare class TicketChangeRequestApprovalsResource extends BaseResource<TicketCh
8096
8338
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8097
8339
  count(params?: TicketChangeRequestApprovalsResourceQueryParams): Promise<number>;
8098
8340
  /** 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>;
8341
+ get(parentId: Identifier, id: Identifier, opts?: {
8342
+ fresh?: boolean;
8343
+ } | null): Promise<TicketChangeRequestApproval>;
8100
8344
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8101
8345
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8102
8346
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8199,7 +8443,9 @@ declare class TicketChargesResource extends BaseResource<TicketCharge, TicketCha
8199
8443
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8200
8444
  count(params?: TicketChargesResourceQueryParams): Promise<number>;
8201
8445
  /** 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>;
8446
+ get(parentId: Identifier, id: Identifier, opts?: {
8447
+ fresh?: boolean;
8448
+ } | null): Promise<TicketCharge>;
8203
8449
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8204
8450
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8205
8451
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8250,7 +8496,9 @@ declare class TicketChecklistItemsResource extends BaseResource<TicketChecklistI
8250
8496
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8251
8497
  count(params?: TicketChecklistItemsResourceQueryParams): Promise<number>;
8252
8498
  /** 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>;
8499
+ get(parentId: Identifier, id: Identifier, opts?: {
8500
+ fresh?: boolean;
8501
+ } | null): Promise<TicketChecklistItem>;
8254
8502
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8255
8503
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8256
8504
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8325,8 +8573,10 @@ declare class TicketHistoryResource extends BaseResource<TicketHistory, TicketHi
8325
8573
  queryAll(params?: TicketHistoryResourceQueryParams): Promise<TicketHistory[]>;
8326
8574
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8327
8575
  count(params?: TicketHistoryResourceQueryParams): Promise<number>;
8328
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8329
- get(id: Identifier): Promise<TicketHistory>;
8576
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
8577
+ get(id: Identifier, opts?: {
8578
+ fresh?: boolean;
8579
+ } | null): Promise<TicketHistory>;
8330
8580
  /** Resolve a TicketHistory from a numeric id (or, where the vendor indexes a primary text field,
8331
8581
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
8332
8582
  * a bare value rejects with a config error (ids only);
@@ -8358,7 +8608,9 @@ declare class TicketNoteAttachmentsResource extends BaseResource<TicketNoteAttac
8358
8608
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8359
8609
  count(params?: TicketNoteAttachmentsResourceQueryParams): Promise<number>;
8360
8610
  /** 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>;
8611
+ get(parentId: Identifier, id: Identifier, opts?: {
8612
+ fresh?: boolean;
8613
+ } | null): Promise<TicketNoteAttachment>;
8362
8614
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8363
8615
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8364
8616
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8400,7 +8652,9 @@ declare class TicketNotesResource extends BaseResource<TicketNote, TicketNoteCre
8400
8652
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8401
8653
  count(params?: TicketNotesResourceQueryParams): Promise<number>;
8402
8654
  /** 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>;
8655
+ get(parentId: Identifier, id: Identifier, opts?: {
8656
+ fresh?: boolean;
8657
+ } | null): Promise<TicketNote>;
8404
8658
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8405
8659
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8406
8660
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8441,8 +8695,10 @@ declare class TicketNoteWebhooksResource extends BaseResource<TicketNoteWebhook,
8441
8695
  queryAll(params?: TicketNoteWebhooksResourceQueryParams): Promise<TicketNoteWebhook[]>;
8442
8696
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8443
8697
  count(params?: TicketNoteWebhooksResourceQueryParams): Promise<number>;
8444
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8445
- get(id: Identifier): Promise<TicketNoteWebhook>;
8698
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
8699
+ get(id: Identifier, opts?: {
8700
+ fresh?: boolean;
8701
+ } | null): Promise<TicketNoteWebhook>;
8446
8702
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
8447
8703
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8448
8704
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8496,7 +8752,9 @@ declare class TicketSecondaryResourcesResource extends BaseResource<TicketSecond
8496
8752
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8497
8753
  count(params?: TicketSecondaryResourcesResourceQueryParams): Promise<number>;
8498
8754
  /** 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>;
8755
+ get(parentId: Identifier, id: Identifier, opts?: {
8756
+ fresh?: boolean;
8757
+ } | null): Promise<TicketSecondaryResource>;
8500
8758
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8501
8759
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8502
8760
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8795,6 +9053,36 @@ interface TicketsForResourceOptions {
8795
9053
  limit?: number;
8796
9054
  /** Extra Ticket fields on top of the pinned projection (id, ticketNumber, title, status, assignedResourceID, companyID). */
8797
9055
  includeFields?: string[];
9056
+ /** `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). */
9057
+ allowAssumed?: boolean;
9058
+ /** `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. */
9059
+ countOnly?: boolean;
9060
+ }
9061
+ /** Options that select the rows result (`countOnly` absent or false). */
9062
+ type TicketsForResourceListOptions = Omit<TicketsForResourceOptions, 'countOnly'> & {
9063
+ countOnly?: false;
9064
+ };
9065
+ /** Options that select the count-only result. */
9066
+ type TicketsForResourceCountOptions = Omit<TicketsForResourceOptions, 'countOnly'> & {
9067
+ countOnly: true;
9068
+ };
9069
+ /**
9070
+ * The count-only result (issue #248). All figures count OPEN tickets (the same
9071
+ * filter as `tickets.count` with `status` not in the closed set): `primary`
9072
+ * equals `tickets.count({ filter: [assignedResourceID eq R, open leaf] })`,
9073
+ * `secondary` is the de-duplicated open secondary ticket ids, `both` their
9074
+ * overlap, `open` the union (primary + secondary - both).
9075
+ */
9076
+ interface TicketsForResourceCountResult {
9077
+ resourceID: number;
9078
+ scope: TicketAssignmentScope;
9079
+ primary: number;
9080
+ secondary: number;
9081
+ both: number;
9082
+ open: number;
9083
+ /** True only when the secondary link read had more pages than it read, so `secondary`/`both`/`open` may undercount. */
9084
+ capped: boolean;
9085
+ closedStatus: TicketStatusDisclosure;
8798
9086
  }
8799
9087
  interface TicketsForResourceResult {
8800
9088
  resourceID: number;
@@ -8862,8 +9150,10 @@ declare class TicketsResource extends BaseResource<Ticket, TicketCreate, TicketU
8862
9150
  queryAll(params?: TicketsResourceQueryParams): Promise<Ticket[]>;
8863
9151
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8864
9152
  count(params?: TicketsResourceQueryParams): Promise<number>;
8865
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8866
- get(id: Identifier): Promise<Ticket>;
9153
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
9154
+ get(id: Identifier, opts?: {
9155
+ fresh?: boolean;
9156
+ } | null): Promise<Ticket>;
8867
9157
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
8868
9158
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8869
9159
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8927,7 +9217,9 @@ declare class TicketsResource extends BaseResource<Ticket, TicketCreate, TicketU
8927
9217
  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
8928
9218
  statusSemantics(opts?: TicketStatusOptions): Promise<TicketStatusSemantics>;
8929
9219
  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
8930
- forResource(resourceID: Identifier, opts?: TicketsForResourceOptions): Promise<TicketsForResourceResult>;
9220
+ forResource(resourceID: Identifier, opts?: TicketsForResourceListOptions): Promise<TicketsForResourceResult>;
9221
+ forResource(resourceID: Identifier, opts: TicketsForResourceCountOptions): Promise<TicketsForResourceCountResult>;
9222
+ forResource(resourceID: Identifier, opts?: TicketsForResourceOptions): Promise<TicketsForResourceResult | TicketsForResourceCountResult>;
8931
9223
  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
8932
9224
  lineOfBusiness(ticketId: Identifier, associationId?: Identifier): Promise<TicketLineOfBusinessResult>;
8933
9225
  }
@@ -8950,8 +9242,10 @@ declare class TicketWebhooksResource extends BaseResource<TicketWebhook, TicketW
8950
9242
  queryAll(params?: TicketWebhooksResourceQueryParams): Promise<TicketWebhook[]>;
8951
9243
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8952
9244
  count(params?: TicketWebhooksResourceQueryParams): Promise<number>;
8953
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8954
- get(id: Identifier): Promise<TicketWebhook>;
9245
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
9246
+ get(id: Identifier, opts?: {
9247
+ fresh?: boolean;
9248
+ } | null): Promise<TicketWebhook>;
8955
9249
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
8956
9250
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8957
9251
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -9213,8 +9507,10 @@ declare class TimeEntriesResource extends BaseResource<TimeEntry, TimeEntryCreat
9213
9507
  queryAll(params?: TimeEntriesResourceQueryParams): Promise<TimeEntry[]>;
9214
9508
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
9215
9509
  count(params?: TimeEntriesResourceQueryParams): Promise<number>;
9216
- /** Get one record by id (item envelope; item: null → NotFoundError). */
9217
- get(id: Identifier): Promise<TimeEntry>;
9510
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
9511
+ get(id: Identifier, opts?: {
9512
+ fresh?: boolean;
9513
+ } | null): Promise<TimeEntry>;
9218
9514
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
9219
9515
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
9220
9516
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -9304,7 +9600,9 @@ declare class TimeEntryAttachmentsResource extends BaseResource<TimeEntryAttachm
9304
9600
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
9305
9601
  count(params?: TimeEntryAttachmentsResourceQueryParams): Promise<number>;
9306
9602
  /** 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>;
9603
+ get(parentId: Identifier, id: Identifier, opts?: {
9604
+ fresh?: boolean;
9605
+ } | null): Promise<TimeEntryAttachment>;
9308
9606
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
9309
9607
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
9310
9608
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -9343,8 +9641,10 @@ declare class TimeOffRequestsResource extends BaseResource<TimeOffRequest, TimeO
9343
9641
  queryAll(params?: TimeOffRequestsResourceQueryParams): Promise<TimeOffRequest[]>;
9344
9642
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
9345
9643
  count(params?: TimeOffRequestsResourceQueryParams): Promise<number>;
9346
- /** Get one record by id (item envelope; item: null → NotFoundError). */
9347
- get(id: Identifier): Promise<TimeOffRequest>;
9644
+ /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
9645
+ get(id: Identifier, opts?: {
9646
+ fresh?: boolean;
9647
+ } | null): Promise<TimeOffRequest>;
9348
9648
  /** Resolve a TimeOffRequest from a numeric id (or, where the vendor indexes a primary text field,
9349
9649
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
9350
9650
  * a bare value rejects with a config error (ids only);
@@ -9623,4 +9923,4 @@ declare class AutotaskClient {
9623
9923
  }): Promise<PromiseSettledResult<R>[]>;
9624
9924
  }
9625
9925
 
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 };
9926
+ 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 CreateGuidanceRow as eA, type CreateBlockerKind as eB, type CreateGuidanceReport as eC, type FieldCacheKind as eD, FIELD_CACHE_KINDS as eE, 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 CreateGuidanceValueRequirement 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 };