node-autotask 0.32.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 (40) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/MCP_TOOL_CATALOG.json +27 -8
  3. package/MCP_TOOL_MANIFEST.md +14 -13
  4. package/N8N_MCP_MANIFEST.json +38 -12
  5. package/N8N_MCP_MANIFEST.md +10 -9
  6. package/README.md +1 -1
  7. package/capabilities.json +4228 -2547
  8. package/capabilities.schema.json +32 -0
  9. package/dist/capabilities.cjs +2 -2
  10. package/dist/capabilities.d.cts +13 -1
  11. package/dist/capabilities.d.ts +13 -1
  12. package/dist/capabilities.js +1 -1
  13. package/dist/{chunk-M2EGFPGF.js → chunk-4MUBUSTL.js} +4227 -2546
  14. package/dist/{chunk-FVHPN7ZR.js → chunk-6ADFCU3I.js} +636 -429
  15. package/dist/{chunk-FTF2FEQ6.cjs → chunk-DKJP73FX.cjs} +1176 -969
  16. package/dist/{chunk-R6HLJCI2.js → chunk-EZKM4HQ6.js} +1038 -573
  17. package/dist/{chunk-DCTHO7CQ.cjs → chunk-FOOHJBPP.cjs} +4227 -2546
  18. package/dist/{chunk-IKPFR6K2.cjs → chunk-GDQ4QM7Q.cjs} +1085 -620
  19. package/dist/{chunk-QCB4LYKD.cjs → chunk-P6YN2POI.cjs} +143 -143
  20. package/dist/{chunk-T6EDJRLT.js → chunk-RDFL5QYE.js} +2 -2
  21. package/dist/{index-Cw4aNNMo.d.ts → index-ByMU8IC2.d.ts} +584 -198
  22. package/dist/{index-OkbCWcef.d.cts → index-Dx4-zpDo.d.cts} +584 -198
  23. package/dist/index.cjs +22 -22
  24. package/dist/index.d.cts +2 -2
  25. package/dist/index.d.ts +2 -2
  26. package/dist/index.js +4 -4
  27. package/dist/operations/index.cjs +165 -137
  28. package/dist/operations/index.d.cts +39 -25
  29. package/dist/operations/index.d.ts +39 -25
  30. package/dist/operations/index.js +48 -20
  31. package/dist/pool.cjs +9 -9
  32. package/dist/pool.d.cts +1 -1
  33. package/dist/pool.d.ts +1 -1
  34. package/dist/pool.js +4 -4
  35. package/dist/resources/index.cjs +4 -4
  36. package/dist/resources/index.d.cts +1 -1
  37. package/dist/resources/index.d.ts +1 -1
  38. package/dist/resources/index.js +3 -3
  39. package/docs/API.md +161 -36
  40. package/package.json +2 -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: eb91032d723d5b0ca909da740889a5e28cf606ab4ee9e749de3127c287ab0471
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> {
@@ -2824,6 +2863,90 @@ interface CompanyFullProfile {
2824
2863
  };
2825
2864
  }
2826
2865
 
2866
+ type CrmIntent = 'create_company' | 'add_contact' | 'update_contact' | 'update_company';
2867
+ interface CrmPrepareInput {
2868
+ intent: CrmIntent;
2869
+ company?: {
2870
+ id?: number;
2871
+ companyName?: string;
2872
+ /** A bare domain or URL; derived from `website` or the contact email when omitted. */
2873
+ domain?: string;
2874
+ website?: string;
2875
+ phone?: string;
2876
+ companyType?: number;
2877
+ ownerResourceID?: number;
2878
+ address1?: string;
2879
+ city?: string;
2880
+ state?: string;
2881
+ postalCode?: string;
2882
+ countryID?: number;
2883
+ };
2884
+ contact?: {
2885
+ id?: number;
2886
+ firstName?: string;
2887
+ lastName?: string;
2888
+ emailAddress?: string;
2889
+ phone?: string;
2890
+ mobilePhone?: string;
2891
+ companyLocationID?: number;
2892
+ /** Used only to pick a location when the company has several. */
2893
+ city?: string;
2894
+ state?: string;
2895
+ postalCode?: string;
2896
+ };
2897
+ }
2898
+ /** One thing the caller must still supply, with how to get it. */
2899
+ interface CrmNeedsInput {
2900
+ field: string;
2901
+ why: string;
2902
+ /** `live-proven`: the vendor demanded it on a real create; `policy`: this planner requires it (CRM hygiene). */
2903
+ source: 'live-proven' | 'policy';
2904
+ /** How to obtain the value: a lookup to run, or candidates to choose from. */
2905
+ lookup?: Record<string, unknown>;
2906
+ /** `web_if_available_else_ask`: search the web when the client can, otherwise ask the user; confirm any web-sourced value before writing. `lookup`: resolve it with the lookup, do not ask. `ask`: only the user knows. */
2907
+ research: 'web_if_available_else_ask' | 'lookup' | 'ask';
2908
+ }
2909
+ interface CrmCompanyCandidate {
2910
+ id: number;
2911
+ companyName: string | null;
2912
+ webAddress: string | null;
2913
+ phone: string | null;
2914
+ isActive: boolean | null;
2915
+ }
2916
+ interface CrmPrepareResult {
2917
+ intent: CrmIntent;
2918
+ company: {
2919
+ status: 'matched' | 'ambiguous' | 'none' | 'not_searched';
2920
+ matchedBy: string | null;
2921
+ candidates: CrmCompanyCandidate[];
2922
+ };
2923
+ locations: null | {
2924
+ items: Array<{
2925
+ id: number;
2926
+ name: string | null;
2927
+ isPrimary: boolean | null;
2928
+ isActive: boolean | null;
2929
+ city: string | null;
2930
+ state: string | null;
2931
+ postalCode: string | null;
2932
+ }>;
2933
+ pick: {
2934
+ rule: 'single' | 'matched' | 'ask' | 'none';
2935
+ locationID: number | null;
2936
+ };
2937
+ };
2938
+ contacts: null | {
2939
+ duplicates: Array<Record<string, unknown>>;
2940
+ matchedBy: 'email' | 'name' | null;
2941
+ };
2942
+ needsInput: CrmNeedsInput[];
2943
+ next: null | {
2944
+ operation: string;
2945
+ note: string;
2946
+ };
2947
+ caveats: string[];
2948
+ }
2949
+
2827
2950
  /** The closed `source` set for `companies.unbilledWork`. */
2828
2951
  type UnbilledWorkSource = 'posted_uninvoiced' | 'invoice' | 'date_range' | 'tickets';
2829
2952
  /** Options for `unbilledWork` (closed bag; the pinned defaults). */
@@ -2945,8 +3068,10 @@ declare class CompaniesResource extends BaseResource<Company, CompanyCreate, Com
2945
3068
  queryAll(params?: CompaniesResourceQueryParams): Promise<Company[]>;
2946
3069
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
2947
3070
  count(params?: CompaniesResourceQueryParams): Promise<number>;
2948
- /** Get one record by id (item envelope; item: null → NotFoundError). */
2949
- 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>;
2950
3075
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
2951
3076
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
2952
3077
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3003,6 +3128,8 @@ declare class CompaniesResource extends BaseResource<Company, CompanyCreate, Com
3003
3128
  fullProfile(id: Identifier, opts?: CompanyFullProfileOptions): Promise<CompanyFullProfile>;
3004
3129
  /** Node-parity special op (hand-written in src/resources/special/companies.ts). */
3005
3130
  unbilledWork(id: Identifier, opts?: UnbilledWorkOptions): Promise<UnbilledWorkResult>;
3131
+ /** Node-parity special op (hand-written in src/resources/special/companies.ts). */
3132
+ prepareCrmWrite(input: CrmPrepareInput): Promise<CrmPrepareResult>;
3006
3133
  }
3007
3134
 
3008
3135
  /**
@@ -3024,7 +3151,9 @@ declare class CompanyAlertsResource extends BaseResource<CompanyAlert, CompanyAl
3024
3151
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3025
3152
  count(params?: CompanyAlertsResourceQueryParams): Promise<number>;
3026
3153
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/Alerts/{id} — vendor item envelope; item: null → NotFoundError). */
3027
- get(parentId: Identifier, id: Identifier): Promise<CompanyAlert>;
3154
+ get(parentId: Identifier, id: Identifier, opts?: {
3155
+ fresh?: boolean;
3156
+ } | null): Promise<CompanyAlert>;
3028
3157
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3029
3158
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3030
3159
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3069,7 +3198,9 @@ declare class CompanyLocationsResource extends BaseResource<CompanyLocation, Com
3069
3198
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3070
3199
  count(params?: CompanyLocationsResourceQueryParams): Promise<number>;
3071
3200
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/Locations/{id} — vendor item envelope; item: null → NotFoundError). */
3072
- get(parentId: Identifier, id: Identifier): Promise<CompanyLocation>;
3201
+ get(parentId: Identifier, id: Identifier, opts?: {
3202
+ fresh?: boolean;
3203
+ } | null): Promise<CompanyLocation>;
3073
3204
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3074
3205
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3075
3206
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3118,7 +3249,9 @@ declare class CompanyNotesResource extends BaseResource<CompanyNote, CompanyNote
3118
3249
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3119
3250
  count(params?: CompanyNotesResourceQueryParams): Promise<number>;
3120
3251
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
3121
- get(parentId: Identifier, id: Identifier): Promise<CompanyNote>;
3252
+ get(parentId: Identifier, id: Identifier, opts?: {
3253
+ fresh?: boolean;
3254
+ } | null): Promise<CompanyNote>;
3122
3255
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3123
3256
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3124
3257
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3164,7 +3297,9 @@ declare class CompanySiteConfigurationsResource extends BaseResource<CompanySite
3164
3297
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3165
3298
  count(params?: CompanySiteConfigurationsResourceQueryParams): Promise<number>;
3166
3299
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/SiteConfigurations/{id} — vendor item envelope; item: null → NotFoundError). */
3167
- get(parentId: Identifier, id: Identifier): Promise<CompanySiteConfigurations>;
3300
+ get(parentId: Identifier, id: Identifier, opts?: {
3301
+ fresh?: boolean;
3302
+ } | null): Promise<CompanySiteConfigurations>;
3168
3303
  /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
3169
3304
  * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
3170
3305
  * the pinned envelope with the best-effort diff; a caller-supplied lastModifiedDate that
@@ -3200,8 +3335,10 @@ declare class CompanyWebhooksResource extends BaseResource<CompanyWebhook, Compa
3200
3335
  queryAll(params?: CompanyWebhooksResourceQueryParams): Promise<CompanyWebhook[]>;
3201
3336
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3202
3337
  count(params?: CompanyWebhooksResourceQueryParams): Promise<number>;
3203
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3204
- 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>;
3205
3342
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3206
3343
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3207
3344
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3255,7 +3392,9 @@ declare class ConfigurationItemBillingProductAssociationsResource extends BaseRe
3255
3392
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3256
3393
  count(params?: ConfigurationItemBillingProductAssociationsResourceQueryParams): Promise<number>;
3257
3394
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/BillingProductAssociations/{id} — vendor item envelope; item: null → NotFoundError). */
3258
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemBillingProductAssociations>;
3395
+ get(parentId: Identifier, id: Identifier, opts?: {
3396
+ fresh?: boolean;
3397
+ } | null): Promise<ConfigurationItemBillingProductAssociations>;
3259
3398
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3260
3399
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3261
3400
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3297,8 +3436,10 @@ declare class ConfigurationItemCategoriesResource extends BaseResource<Configura
3297
3436
  queryAll(params?: ConfigurationItemCategoriesResourceQueryParams): Promise<ConfigurationItemCategory[]>;
3298
3437
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3299
3438
  count(params?: ConfigurationItemCategoriesResourceQueryParams): Promise<number>;
3300
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3301
- 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>;
3302
3443
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3303
3444
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3304
3445
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3349,7 +3490,9 @@ declare class ConfigurationItemCategoryUdfAssociationsResource extends BaseResou
3349
3490
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3350
3491
  count(params?: ConfigurationItemCategoryUdfAssociationsResourceQueryParams): Promise<number>;
3351
3492
  /** Get one record by parent + id (/V1.0/ConfigurationItemCategories/{parentId}/UdfAssociations/{id} — vendor item envelope; item: null → NotFoundError). */
3352
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemCategoryUdfAssociation>;
3493
+ get(parentId: Identifier, id: Identifier, opts?: {
3494
+ fresh?: boolean;
3495
+ } | null): Promise<ConfigurationItemCategoryUdfAssociation>;
3353
3496
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3354
3497
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3355
3498
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3394,7 +3537,9 @@ declare class ConfigurationItemDnsRecordsResource extends BaseResource<Configura
3394
3537
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3395
3538
  count(params?: ConfigurationItemDnsRecordsResourceQueryParams): Promise<number>;
3396
3539
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/DnsRecords/{id} — vendor item envelope; item: null → NotFoundError). */
3397
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemDnsRecord>;
3540
+ get(parentId: Identifier, id: Identifier, opts?: {
3541
+ fresh?: boolean;
3542
+ } | null): Promise<ConfigurationItemDnsRecord>;
3398
3543
  /** Delete a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the pinned
3399
3544
  * envelope and never issues the delete. */
3400
3545
  delete(parentId: Identifier, id: Identifier, opts?: MutationOpts): Promise<OperationResult | DryRunResult<Record<string, unknown>>>;
@@ -3429,7 +3574,9 @@ declare class ConfigurationItemNotesResource extends BaseResource<ConfigurationI
3429
3574
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3430
3575
  count(params?: ConfigurationItemNotesResourceQueryParams): Promise<number>;
3431
3576
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
3432
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemNote>;
3577
+ get(parentId: Identifier, id: Identifier, opts?: {
3578
+ fresh?: boolean;
3579
+ } | null): Promise<ConfigurationItemNote>;
3433
3580
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3434
3581
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3435
3582
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3471,7 +3618,9 @@ declare class ConfigurationItemRelatedItemsResource extends BaseResource<Configu
3471
3618
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3472
3619
  count(params?: ConfigurationItemRelatedItemsResourceQueryParams): Promise<number>;
3473
3620
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/RelatedItems/{id} — vendor item envelope; item: null → NotFoundError). */
3474
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemRelatedItem>;
3621
+ get(parentId: Identifier, id: Identifier, opts?: {
3622
+ fresh?: boolean;
3623
+ } | null): Promise<ConfigurationItemRelatedItem>;
3475
3624
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3476
3625
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3477
3626
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3594,8 +3743,10 @@ declare class ConfigurationItemsResource extends BaseResource<ConfigurationItem,
3594
3743
  queryAll(params?: ConfigurationItemsResourceQueryParams): Promise<ConfigurationItem[]>;
3595
3744
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3596
3745
  count(params?: ConfigurationItemsResourceQueryParams): Promise<number>;
3597
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3598
- 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>;
3599
3750
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3600
3751
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3601
3752
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3655,7 +3806,9 @@ declare class ConfigurationItemSslSubjectAlternativeNamesResource extends BaseRe
3655
3806
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3656
3807
  count(params?: ConfigurationItemSslSubjectAlternativeNamesResourceQueryParams): Promise<number>;
3657
3808
  /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/SslSubjectAlternativeNames/{id} — vendor item envelope; item: null → NotFoundError). */
3658
- get(parentId: Identifier, id: Identifier): Promise<ConfigurationItemSslSubjectAlternativeName>;
3809
+ get(parentId: Identifier, id: Identifier, opts?: {
3810
+ fresh?: boolean;
3811
+ } | null): Promise<ConfigurationItemSslSubjectAlternativeName>;
3659
3812
  /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
3660
3813
  * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
3661
3814
  * the pinned envelope with the best-effort diff; a caller-supplied lastModifiedDate that
@@ -3696,8 +3849,10 @@ declare class ConfigurationItemTypesResource extends BaseResource<ConfigurationI
3696
3849
  queryAll(params?: ConfigurationItemTypesResourceQueryParams): Promise<ConfigurationItemType[]>;
3697
3850
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3698
3851
  count(params?: ConfigurationItemTypesResourceQueryParams): Promise<number>;
3699
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3700
- 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>;
3701
3856
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3702
3857
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3703
3858
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3750,8 +3905,10 @@ declare class ConfigurationItemWebhooksResource extends BaseResource<Configurati
3750
3905
  queryAll(params?: ConfigurationItemWebhooksResourceQueryParams): Promise<ConfigurationItemWebhook[]>;
3751
3906
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3752
3907
  count(params?: ConfigurationItemWebhooksResourceQueryParams): Promise<number>;
3753
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3754
- 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>;
3755
3912
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3756
3913
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3757
3914
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3802,8 +3959,10 @@ declare class ContactGroupContactsResource extends BaseResource<ContactGroupCont
3802
3959
  queryAll(params?: ContactGroupContactsResourceQueryParams): Promise<ContactGroupContacts[]>;
3803
3960
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3804
3961
  count(params?: ContactGroupContactsResourceQueryParams): Promise<number>;
3805
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3806
- 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>;
3807
3966
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3808
3967
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3809
3968
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3840,8 +3999,10 @@ declare class ContactGroupsResource extends BaseResource<ContactGroups, ContactG
3840
3999
  queryAll(params?: ContactGroupsResourceQueryParams): Promise<ContactGroups[]>;
3841
4000
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3842
4001
  count(params?: ContactGroupsResourceQueryParams): Promise<number>;
3843
- /** Get one record by id (item envelope; item: null → NotFoundError). */
3844
- 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>;
3845
4006
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
3846
4007
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3847
4008
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -3952,7 +4113,9 @@ declare class ContactsResource extends BaseResource<Contact, ContactCreate, Cont
3952
4113
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
3953
4114
  count(params?: ContactsResourceQueryParams): Promise<number>;
3954
4115
  /** Get one record by parent + id (/V1.0/Companies/{parentId}/Contacts/{id} — vendor item envelope; item: null → NotFoundError). */
3955
- get(parentId: Identifier, id: Identifier): Promise<Contact>;
4116
+ get(parentId: Identifier, id: Identifier, opts?: {
4117
+ fresh?: boolean;
4118
+ } | null): Promise<Contact>;
3956
4119
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
3957
4120
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
3958
4121
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4009,8 +4172,10 @@ declare class ContactWebhooksResource extends BaseResource<ContactWebhook, Conta
4009
4172
  queryAll(params?: ContactWebhooksResourceQueryParams): Promise<ContactWebhook[]>;
4010
4173
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4011
4174
  count(params?: ContactWebhooksResourceQueryParams): Promise<number>;
4012
- /** Get one record by id (item envelope; item: null → NotFoundError). */
4013
- 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>;
4014
4179
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
4015
4180
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4016
4181
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4064,7 +4229,9 @@ declare class ContractBillingRulesResource extends BaseResource<ContractBillingR
4064
4229
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4065
4230
  count(params?: ContractBillingRulesResourceQueryParams): Promise<number>;
4066
4231
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/BillingRules/{id} — vendor item envelope; item: null → NotFoundError). */
4067
- get(parentId: Identifier, id: Identifier): Promise<ContractBillingRule>;
4232
+ get(parentId: Identifier, id: Identifier, opts?: {
4233
+ fresh?: boolean;
4234
+ } | null): Promise<ContractBillingRule>;
4068
4235
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4069
4236
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4070
4237
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4109,7 +4276,9 @@ declare class ContractBlockHourFactorsResource extends BaseResource<ContractBloc
4109
4276
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4110
4277
  count(params?: ContractBlockHourFactorsResourceQueryParams): Promise<number>;
4111
4278
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/BlockHourFactors/{id} — vendor item envelope; item: null → NotFoundError). */
4112
- get(parentId: Identifier, id: Identifier): Promise<ContractBlockHourFactor>;
4279
+ get(parentId: Identifier, id: Identifier, opts?: {
4280
+ fresh?: boolean;
4281
+ } | null): Promise<ContractBlockHourFactor>;
4113
4282
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4114
4283
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4115
4284
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4151,7 +4320,9 @@ declare class ContractBlocksResource extends BaseResource<ContractBlock, Contrac
4151
4320
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4152
4321
  count(params?: ContractBlocksResourceQueryParams): Promise<number>;
4153
4322
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Blocks/{id} — vendor item envelope; item: null → NotFoundError). */
4154
- get(parentId: Identifier, id: Identifier): Promise<ContractBlock>;
4323
+ get(parentId: Identifier, id: Identifier, opts?: {
4324
+ fresh?: boolean;
4325
+ } | null): Promise<ContractBlock>;
4155
4326
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4156
4327
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4157
4328
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4193,7 +4364,9 @@ declare class ContractChargesResource extends BaseResource<ContractCharge, Contr
4193
4364
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4194
4365
  count(params?: ContractChargesResourceQueryParams): Promise<number>;
4195
4366
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
4196
- get(parentId: Identifier, id: Identifier): Promise<ContractCharge>;
4367
+ get(parentId: Identifier, id: Identifier, opts?: {
4368
+ fresh?: boolean;
4369
+ } | null): Promise<ContractCharge>;
4197
4370
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4198
4371
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4199
4372
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4242,7 +4415,9 @@ declare class ContractExclusionBillingCodesResource extends BaseResource<Contrac
4242
4415
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4243
4416
  count(params?: ContractExclusionBillingCodesResourceQueryParams): Promise<number>;
4244
4417
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ExclusionBillingCodes/{id} — vendor item envelope; item: null → NotFoundError). */
4245
- get(parentId: Identifier, id: Identifier): Promise<ContractExclusionBillingCode>;
4418
+ get(parentId: Identifier, id: Identifier, opts?: {
4419
+ fresh?: boolean;
4420
+ } | null): Promise<ContractExclusionBillingCode>;
4246
4421
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4247
4422
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4248
4423
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4282,7 +4457,9 @@ declare class ContractExclusionRolesResource extends BaseResource<ContractExclus
4282
4457
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4283
4458
  count(params?: ContractExclusionRolesResourceQueryParams): Promise<number>;
4284
4459
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ExclusionRoles/{id} — vendor item envelope; item: null → NotFoundError). */
4285
- get(parentId: Identifier, id: Identifier): Promise<ContractExclusionRoles>;
4460
+ get(parentId: Identifier, id: Identifier, opts?: {
4461
+ fresh?: boolean;
4462
+ } | null): Promise<ContractExclusionRoles>;
4286
4463
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4287
4464
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4288
4465
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4322,7 +4499,9 @@ declare class ContractExclusionSetExcludedRolesResource extends BaseResource<Con
4322
4499
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4323
4500
  count(params?: ContractExclusionSetExcludedRolesResourceQueryParams): Promise<number>;
4324
4501
  /** Get one record by parent + id (/V1.0/ContractExclusionSets/{parentId}/ExcludedRoles/{id} — vendor item envelope; item: null → NotFoundError). */
4325
- get(parentId: Identifier, id: Identifier): Promise<ContractExclusionSetExcludedRoles>;
4502
+ get(parentId: Identifier, id: Identifier, opts?: {
4503
+ fresh?: boolean;
4504
+ } | null): Promise<ContractExclusionSetExcludedRoles>;
4326
4505
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4327
4506
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4328
4507
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4362,7 +4541,9 @@ declare class ContractExclusionSetExcludedWorkTypesResource extends BaseResource
4362
4541
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4363
4542
  count(params?: ContractExclusionSetExcludedWorkTypesResourceQueryParams): Promise<number>;
4364
4543
  /** Get one record by parent + id (/V1.0/ContractExclusionSets/{parentId}/ExcludedWorkTypes/{id} — vendor item envelope; item: null → NotFoundError). */
4365
- get(parentId: Identifier, id: Identifier): Promise<ContractExclusionSetExcludedWorkTypes>;
4544
+ get(parentId: Identifier, id: Identifier, opts?: {
4545
+ fresh?: boolean;
4546
+ } | null): Promise<ContractExclusionSetExcludedWorkTypes>;
4366
4547
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4367
4548
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4368
4549
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4399,8 +4580,10 @@ declare class ContractExclusionSetsResource extends BaseResource<ContractExclusi
4399
4580
  queryAll(params?: ContractExclusionSetsResourceQueryParams): Promise<ContractExclusionSets[]>;
4400
4581
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4401
4582
  count(params?: ContractExclusionSetsResourceQueryParams): Promise<number>;
4402
- /** Get one record by id (item envelope; item: null → NotFoundError). */
4403
- 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>;
4404
4587
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
4405
4588
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4406
4589
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4454,7 +4637,9 @@ declare class ContractMilestonesResource extends BaseResource<ContractMilestone,
4454
4637
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4455
4638
  count(params?: ContractMilestonesResourceQueryParams): Promise<number>;
4456
4639
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Milestones/{id} — vendor item envelope; item: null → NotFoundError). */
4457
- get(parentId: Identifier, id: Identifier): Promise<ContractMilestone>;
4640
+ get(parentId: Identifier, id: Identifier, opts?: {
4641
+ fresh?: boolean;
4642
+ } | null): Promise<ContractMilestone>;
4458
4643
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4459
4644
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4460
4645
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4496,7 +4681,9 @@ declare class ContractNotesResource extends BaseResource<ContractNote, ContractN
4496
4681
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4497
4682
  count(params?: ContractNotesResourceQueryParams): Promise<number>;
4498
4683
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
4499
- get(parentId: Identifier, id: Identifier): Promise<ContractNote>;
4684
+ get(parentId: Identifier, id: Identifier, opts?: {
4685
+ fresh?: boolean;
4686
+ } | null): Promise<ContractNote>;
4500
4687
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4501
4688
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4502
4689
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4538,7 +4725,9 @@ declare class ContractRatesResource extends BaseResource<ContractRate, ContractR
4538
4725
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4539
4726
  count(params?: ContractRatesResourceQueryParams): Promise<number>;
4540
4727
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Rates/{id} — vendor item envelope; item: null → NotFoundError). */
4541
- get(parentId: Identifier, id: Identifier): Promise<ContractRate>;
4728
+ get(parentId: Identifier, id: Identifier, opts?: {
4729
+ fresh?: boolean;
4730
+ } | null): Promise<ContractRate>;
4542
4731
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4543
4732
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4544
4733
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4580,7 +4769,9 @@ declare class ContractRetainersResource extends BaseResource<ContractRetainers,
4580
4769
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4581
4770
  count(params?: ContractRetainersResourceQueryParams): Promise<number>;
4582
4771
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Retainers/{id} — vendor item envelope; item: null → NotFoundError). */
4583
- get(parentId: Identifier, id: Identifier): Promise<ContractRetainers>;
4772
+ get(parentId: Identifier, id: Identifier, opts?: {
4773
+ fresh?: boolean;
4774
+ } | null): Promise<ContractRetainers>;
4584
4775
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4585
4776
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4586
4777
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4622,7 +4813,9 @@ declare class ContractRoleCostsResource extends BaseResource<ContractRoleCosts,
4622
4813
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4623
4814
  count(params?: ContractRoleCostsResourceQueryParams): Promise<number>;
4624
4815
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/RoleCosts/{id} — vendor item envelope; item: null → NotFoundError). */
4625
- get(parentId: Identifier, id: Identifier): Promise<ContractRoleCosts>;
4816
+ get(parentId: Identifier, id: Identifier, opts?: {
4817
+ fresh?: boolean;
4818
+ } | null): Promise<ContractRoleCosts>;
4626
4819
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4627
4820
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4628
4821
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4722,7 +4915,9 @@ declare class ContractServiceBundlesResource extends BaseResource<ContractServic
4722
4915
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4723
4916
  count(params?: ContractServiceBundlesResourceQueryParams): Promise<number>;
4724
4917
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceBundles/{id} — vendor item envelope; item: null → NotFoundError). */
4725
- get(parentId: Identifier, id: Identifier): Promise<ContractServiceBundle>;
4918
+ get(parentId: Identifier, id: Identifier, opts?: {
4919
+ fresh?: boolean;
4920
+ } | null): Promise<ContractServiceBundle>;
4726
4921
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4727
4922
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4728
4923
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4764,7 +4959,9 @@ declare class ContractServiceBundleUnitsResource extends BaseResource<ContractSe
4764
4959
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4765
4960
  count(params?: ContractServiceBundleUnitsResourceQueryParams): Promise<number>;
4766
4961
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceBundleUnits/{id} — vendor item envelope; item: null → NotFoundError). */
4767
- get(parentId: Identifier, id: Identifier): Promise<ContractServiceBundleUnit>;
4962
+ get(parentId: Identifier, id: Identifier, opts?: {
4963
+ fresh?: boolean;
4964
+ } | null): Promise<ContractServiceBundleUnit>;
4768
4965
  /** Resolve a ContractServiceBundleUnit from a numeric id (or, where the vendor indexes a primary text field,
4769
4966
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
4770
4967
  * a bare value rejects with a config error (ids only);
@@ -4796,7 +4993,9 @@ declare class ContractServicesResource extends BaseResource<ContractService, Con
4796
4993
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4797
4994
  count(params?: ContractServicesResourceQueryParams): Promise<number>;
4798
4995
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Services/{id} — vendor item envelope; item: null → NotFoundError). */
4799
- get(parentId: Identifier, id: Identifier): Promise<ContractService>;
4996
+ get(parentId: Identifier, id: Identifier, opts?: {
4997
+ fresh?: boolean;
4998
+ } | null): Promise<ContractService>;
4800
4999
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
4801
5000
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
4802
5001
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -4838,7 +5037,9 @@ declare class ContractServiceUnitsResource extends BaseResource<ContractServiceU
4838
5037
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
4839
5038
  count(params?: ContractServiceUnitsResourceQueryParams): Promise<number>;
4840
5039
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceUnits/{id} — vendor item envelope; item: null → NotFoundError). */
4841
- get(parentId: Identifier, id: Identifier): Promise<ContractServiceUnit>;
5040
+ get(parentId: Identifier, id: Identifier, opts?: {
5041
+ fresh?: boolean;
5042
+ } | null): Promise<ContractServiceUnit>;
4842
5043
  /** Resolve a ContractServiceUnit from a numeric id (or, where the vendor indexes a primary text field,
4843
5044
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
4844
5045
  * a bare value rejects with a config error (ids only);
@@ -5144,8 +5345,10 @@ declare class ContractsResource extends BaseResource<Contract, ContractCreate, C
5144
5345
  queryAll(params?: ContractsResourceQueryParams): Promise<Contract[]>;
5145
5346
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5146
5347
  count(params?: ContractsResourceQueryParams): Promise<number>;
5147
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5148
- 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>;
5149
5352
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5150
5353
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5151
5354
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5200,7 +5403,9 @@ declare class ContractTicketPurchasesResource extends BaseResource<ContractTicke
5200
5403
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5201
5404
  count(params?: ContractTicketPurchasesResourceQueryParams): Promise<number>;
5202
5405
  /** Get one record by parent + id (/V1.0/Contracts/{parentId}/TicketPurchases/{id} — vendor item envelope; item: null → NotFoundError). */
5203
- get(parentId: Identifier, id: Identifier): Promise<ContractTicketPurchases>;
5406
+ get(parentId: Identifier, id: Identifier, opts?: {
5407
+ fresh?: boolean;
5408
+ } | null): Promise<ContractTicketPurchases>;
5204
5409
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5205
5410
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5206
5411
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5239,8 +5444,10 @@ declare class CountriesResource extends BaseResource<Country, CountryCreate, Cou
5239
5444
  queryAll(params?: CountriesResourceQueryParams): Promise<Country[]>;
5240
5445
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5241
5446
  count(params?: CountriesResourceQueryParams): Promise<number>;
5242
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5243
- 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>;
5244
5451
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
5245
5452
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
5246
5453
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -5283,8 +5490,10 @@ declare class CurrenciesResource extends BaseResource<Currency, CurrencyCreate,
5283
5490
  queryAll(params?: CurrenciesResourceQueryParams): Promise<Currency[]>;
5284
5491
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5285
5492
  count(params?: CurrenciesResourceQueryParams): Promise<number>;
5286
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5287
- 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>;
5288
5497
  /** Resolve a Currency from a numeric id (or, where the vendor indexes a primary text field,
5289
5498
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
5290
5499
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -5317,8 +5526,10 @@ declare class DepartmentsResource extends BaseResource<Department, DepartmentCre
5317
5526
  queryAll(params?: DepartmentsResourceQueryParams): Promise<Department[]>;
5318
5527
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5319
5528
  count(params?: DepartmentsResourceQueryParams): Promise<number>;
5320
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5321
- 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>;
5322
5533
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5323
5534
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5324
5535
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5366,8 +5577,10 @@ declare class DomainRegistrarsResource extends BaseResource<DomainRegistrar, Dom
5366
5577
  queryAll(params?: DomainRegistrarsResourceQueryParams): Promise<DomainRegistrar[]>;
5367
5578
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5368
5579
  count(params?: DomainRegistrarsResourceQueryParams): Promise<number>;
5369
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5370
- 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>;
5371
5584
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5372
5585
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5373
5586
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5433,7 +5646,9 @@ declare class ExpenseItemAttachmentsResource extends BaseResource<ExpenseItemAtt
5433
5646
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5434
5647
  count(params?: ExpenseItemAttachmentsResourceQueryParams): Promise<number>;
5435
5648
  /** Get one record by parent + id (/V1.0/ExpenseItems/{parentId}/Attachments/{id} — vendor answers the model directly). */
5436
- get(parentId: Identifier, id: Identifier): Promise<ExpenseItemAttachment>;
5649
+ get(parentId: Identifier, id: Identifier, opts?: {
5650
+ fresh?: boolean;
5651
+ } | null): Promise<ExpenseItemAttachment>;
5437
5652
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5438
5653
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5439
5654
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5474,8 +5689,10 @@ declare class ExpenseItemsResource extends BaseResource<ExpenseItem, ExpenseItem
5474
5689
  queryAll(params?: ExpenseItemsResourceQueryParams): Promise<ExpenseItem[]>;
5475
5690
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5476
5691
  count(params?: ExpenseItemsResourceQueryParams): Promise<number>;
5477
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5478
- 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>;
5479
5696
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5480
5697
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5481
5698
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5514,8 +5731,10 @@ declare class ExpenseReportsResource extends BaseResource<ExpenseReport, Expense
5514
5731
  queryAll(params?: ExpenseReportsResourceQueryParams): Promise<ExpenseReport[]>;
5515
5732
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5516
5733
  count(params?: ExpenseReportsResourceQueryParams): Promise<number>;
5517
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5518
- 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>;
5519
5738
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5520
5739
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5521
5740
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5563,8 +5782,10 @@ declare class HolidaySetsResource extends BaseResource<HolidaySet, HolidaySetCre
5563
5782
  queryAll(params?: HolidaySetsResourceQueryParams): Promise<HolidaySet[]>;
5564
5783
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5565
5784
  count(params?: HolidaySetsResourceQueryParams): Promise<number>;
5566
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5567
- 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>;
5568
5789
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5569
5790
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5570
5791
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5614,7 +5835,9 @@ declare class HolidaysResource extends BaseResource<Holiday, HolidayCreate, Holi
5614
5835
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5615
5836
  count(params?: HolidaysResourceQueryParams): Promise<number>;
5616
5837
  /** Get one record by parent + id (/V1.0/HolidaySets/{parentId}/Holidays/{id} — vendor item envelope; item: null → NotFoundError). */
5617
- get(parentId: Identifier, id: Identifier): Promise<Holiday>;
5838
+ get(parentId: Identifier, id: Identifier, opts?: {
5839
+ fresh?: boolean;
5840
+ } | null): Promise<Holiday>;
5618
5841
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5619
5842
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5620
5843
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5656,8 +5879,10 @@ declare class InventoryProductsResource extends BaseResource<InventoryProduct, I
5656
5879
  queryAll(params?: InventoryProductsResourceQueryParams): Promise<InventoryProduct[]>;
5657
5880
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5658
5881
  count(params?: InventoryProductsResourceQueryParams): Promise<number>;
5659
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5660
- 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>;
5661
5886
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5662
5887
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5663
5888
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5710,8 +5935,10 @@ declare class InvoicesResource extends BaseResource<Invoice, InvoiceCreate, Invo
5710
5935
  queryAll(params?: InvoicesResourceQueryParams): Promise<Invoice[]>;
5711
5936
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5712
5937
  count(params?: InvoicesResourceQueryParams): Promise<number>;
5713
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5714
- 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>;
5715
5942
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
5716
5943
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
5717
5944
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -5780,8 +6007,10 @@ declare class InvoiceTemplatesResource extends BaseResource<InvoiceTemplate, Inv
5780
6007
  queryAll(params?: InvoiceTemplatesResourceQueryParams): Promise<InvoiceTemplate[]>;
5781
6008
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5782
6009
  count(params?: InvoiceTemplatesResourceQueryParams): Promise<number>;
5783
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5784
- 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>;
5785
6014
  }
5786
6015
 
5787
6016
  /**
@@ -5815,8 +6044,10 @@ declare class NotificationHistoryResource extends BaseResource<NotificationHisto
5815
6044
  queryAll(params?: NotificationHistoryResourceQueryParams): Promise<NotificationHistory[]>;
5816
6045
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5817
6046
  count(params?: NotificationHistoryResourceQueryParams): Promise<number>;
5818
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5819
- 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>;
5820
6051
  /** Resolve a NotificationHistory from a numeric id (or, where the vendor indexes a primary text field,
5821
6052
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
5822
6053
  * a bare value rejects with a config error (ids only);
@@ -5845,8 +6076,10 @@ declare class OpportunitiesResource extends BaseResource<Opportunity, Opportunit
5845
6076
  queryAll(params?: OpportunitiesResourceQueryParams): Promise<Opportunity[]>;
5846
6077
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5847
6078
  count(params?: OpportunitiesResourceQueryParams): Promise<number>;
5848
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5849
- 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>;
5850
6083
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5851
6084
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5852
6085
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5893,7 +6126,9 @@ declare class OpportunityAttachmentsResource extends BaseResource<OpportunityAtt
5893
6126
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5894
6127
  count(params?: OpportunityAttachmentsResourceQueryParams): Promise<number>;
5895
6128
  /** Get one record by parent + id (/V1.0/Opportunities/{parentId}/Attachments/{id} — vendor answers the model directly). */
5896
- get(parentId: Identifier, id: Identifier): Promise<OpportunityAttachment>;
6129
+ get(parentId: Identifier, id: Identifier, opts?: {
6130
+ fresh?: boolean;
6131
+ } | null): Promise<OpportunityAttachment>;
5897
6132
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
5898
6133
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5899
6134
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -5932,8 +6167,10 @@ declare class OpportunityCategoriesResource extends BaseResource<OpportunityCate
5932
6167
  queryAll(params?: OpportunityCategoriesResourceQueryParams): Promise<OpportunityCategory[]>;
5933
6168
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5934
6169
  count(params?: OpportunityCategoriesResourceQueryParams): Promise<number>;
5935
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5936
- 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>;
5937
6174
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
5938
6175
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
5939
6176
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -5976,8 +6213,10 @@ declare class OrganizationalLevel1sResource extends BaseResource<OrganizationalL
5976
6213
  queryAll(params?: OrganizationalLevel1sResourceQueryParams): Promise<OrganizationalLevel1[]>;
5977
6214
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
5978
6215
  count(params?: OrganizationalLevel1sResourceQueryParams): Promise<number>;
5979
- /** Get one record by id (item envelope; item: null → NotFoundError). */
5980
- 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>;
5981
6220
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
5982
6221
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
5983
6222
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6011,8 +6250,10 @@ declare class OrganizationalLevel2sResource extends BaseResource<OrganizationalL
6011
6250
  queryAll(params?: OrganizationalLevel2sResourceQueryParams): Promise<OrganizationalLevel2[]>;
6012
6251
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6013
6252
  count(params?: OrganizationalLevel2sResourceQueryParams): Promise<number>;
6014
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6015
- 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>;
6016
6257
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6017
6258
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6018
6259
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6046,8 +6287,10 @@ declare class OrganizationalLevelAssociationsResource extends BaseResource<Organ
6046
6287
  queryAll(params?: OrganizationalLevelAssociationsResourceQueryParams): Promise<OrganizationalLevelAssociation[]>;
6047
6288
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6048
6289
  count(params?: OrganizationalLevelAssociationsResourceQueryParams): Promise<number>;
6049
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6050
- 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>;
6051
6294
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6052
6295
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6053
6296
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6084,7 +6327,9 @@ declare class PhasesResource extends BaseResource<Phase, PhaseCreate, PhaseUpdat
6084
6327
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6085
6328
  count(params?: PhasesResourceQueryParams): Promise<number>;
6086
6329
  /** Get one record by parent + id (/V1.0/Projects/{parentId}/Phases/{id} — vendor item envelope; item: null → NotFoundError). */
6087
- get(parentId: Identifier, id: Identifier): Promise<Phase>;
6330
+ get(parentId: Identifier, id: Identifier, opts?: {
6331
+ fresh?: boolean;
6332
+ } | null): Promise<Phase>;
6088
6333
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6089
6334
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6090
6335
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6123,8 +6368,10 @@ declare class ProductsResource extends BaseResource<Product, ProductCreate, Prod
6123
6368
  queryAll(params?: ProductsResourceQueryParams): Promise<Product[]>;
6124
6369
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6125
6370
  count(params?: ProductsResourceQueryParams): Promise<number>;
6126
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6127
- 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>;
6128
6375
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6129
6376
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6130
6377
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6175,7 +6422,9 @@ declare class ProductVendorsResource extends BaseResource<ProductVendors, Produc
6175
6422
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6176
6423
  count(params?: ProductVendorsResourceQueryParams): Promise<number>;
6177
6424
  /** Get one record by parent + id (/V1.0/Products/{parentId}/Vendors/{id} — vendor item envelope; item: null → NotFoundError). */
6178
- get(parentId: Identifier, id: Identifier): Promise<ProductVendors>;
6425
+ get(parentId: Identifier, id: Identifier, opts?: {
6426
+ fresh?: boolean;
6427
+ } | null): Promise<ProductVendors>;
6179
6428
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6180
6429
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6181
6430
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6217,7 +6466,9 @@ declare class ProjectChargesResource extends BaseResource<ProjectCharge, Project
6217
6466
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6218
6467
  count(params?: ProjectChargesResourceQueryParams): Promise<number>;
6219
6468
  /** Get one record by parent + id (/V1.0/Projects/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
6220
- get(parentId: Identifier, id: Identifier): Promise<ProjectCharge>;
6469
+ get(parentId: Identifier, id: Identifier, opts?: {
6470
+ fresh?: boolean;
6471
+ } | null): Promise<ProjectCharge>;
6221
6472
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6222
6473
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6223
6474
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6266,7 +6517,9 @@ declare class ProjectNotesResource extends BaseResource<ProjectNote, ProjectNote
6266
6517
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6267
6518
  count(params?: ProjectNotesResourceQueryParams): Promise<number>;
6268
6519
  /** Get one record by parent + id (/V1.0/Projects/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
6269
- get(parentId: Identifier, id: Identifier): Promise<ProjectNote>;
6520
+ get(parentId: Identifier, id: Identifier, opts?: {
6521
+ fresh?: boolean;
6522
+ } | null): Promise<ProjectNote>;
6270
6523
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6271
6524
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6272
6525
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6305,8 +6558,10 @@ declare class ProjectsResource extends BaseResource<Project, ProjectCreate, Proj
6305
6558
  queryAll(params?: ProjectsResourceQueryParams): Promise<Project[]>;
6306
6559
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6307
6560
  count(params?: ProjectsResourceQueryParams): Promise<number>;
6308
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6309
- 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>;
6310
6565
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6311
6566
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6312
6567
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6360,8 +6615,10 @@ declare class PurchaseApprovalsResource extends BaseResource<PurchaseApprovals,
6360
6615
  queryAll(params?: PurchaseApprovalsResourceQueryParams): Promise<PurchaseApprovals[]>;
6361
6616
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6362
6617
  count(params?: PurchaseApprovalsResourceQueryParams): Promise<number>;
6363
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6364
- 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>;
6365
6622
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
6366
6623
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
6367
6624
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -6403,7 +6660,9 @@ declare class PurchaseOrderItemReceivingResource extends BaseResource<PurchaseOr
6403
6660
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6404
6661
  count(params?: PurchaseOrderItemReceivingResourceQueryParams): Promise<number>;
6405
6662
  /** Get one record by parent + id (/V1.0/PurchaseOrderItems/{parentId}/Receiving/{id} — vendor item envelope; item: null → NotFoundError). */
6406
- get(parentId: Identifier, id: Identifier): Promise<PurchaseOrderItemReceiving>;
6663
+ get(parentId: Identifier, id: Identifier, opts?: {
6664
+ fresh?: boolean;
6665
+ } | null): Promise<PurchaseOrderItemReceiving>;
6407
6666
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6408
6667
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6409
6668
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6440,7 +6699,9 @@ declare class PurchaseOrderItemsResource extends BaseResource<PurchaseOrderItems
6440
6699
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6441
6700
  count(params?: PurchaseOrderItemsResourceQueryParams): Promise<number>;
6442
6701
  /** Get one record by parent + id (/V1.0/PurchaseOrders/{parentId}/Items/{id} — vendor item envelope; item: null → NotFoundError). */
6443
- get(parentId: Identifier, id: Identifier): Promise<PurchaseOrderItems>;
6702
+ get(parentId: Identifier, id: Identifier, opts?: {
6703
+ fresh?: boolean;
6704
+ } | null): Promise<PurchaseOrderItems>;
6444
6705
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6445
6706
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6446
6707
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6479,8 +6740,10 @@ declare class PurchaseOrdersResource extends BaseResource<PurchaseOrders, Purcha
6479
6740
  queryAll(params?: PurchaseOrdersResourceQueryParams): Promise<PurchaseOrders[]>;
6480
6741
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6481
6742
  count(params?: PurchaseOrdersResourceQueryParams): Promise<number>;
6482
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6483
- 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>;
6484
6747
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6485
6748
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6486
6749
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6527,7 +6790,9 @@ declare class QuoteItemsResource extends BaseResource<QuoteItem, QuoteItemCreate
6527
6790
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6528
6791
  count(params?: QuoteItemsResourceQueryParams): Promise<number>;
6529
6792
  /** Get one record by parent + id (/V1.0/Quotes/{parentId}/Items/{id} — vendor item envelope; item: null → NotFoundError). */
6530
- get(parentId: Identifier, id: Identifier): Promise<QuoteItem>;
6793
+ get(parentId: Identifier, id: Identifier, opts?: {
6794
+ fresh?: boolean;
6795
+ } | null): Promise<QuoteItem>;
6531
6796
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6532
6797
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6533
6798
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6575,8 +6840,10 @@ declare class QuoteLocationsResource extends BaseResource<QuoteLocation, QuoteLo
6575
6840
  queryAll(params?: QuoteLocationsResourceQueryParams): Promise<QuoteLocation[]>;
6576
6841
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6577
6842
  count(params?: QuoteLocationsResourceQueryParams): Promise<number>;
6578
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6579
- 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>;
6580
6847
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6581
6848
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6582
6849
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6620,8 +6887,10 @@ declare class QuotesResource extends BaseResource<Quote, QuoteCreate, QuoteUpdat
6620
6887
  queryAll(params?: QuotesResourceQueryParams): Promise<Quote[]>;
6621
6888
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6622
6889
  count(params?: QuotesResourceQueryParams): Promise<number>;
6623
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6624
- 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>;
6625
6894
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
6626
6895
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6627
6896
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6669,8 +6938,10 @@ declare class QuoteTemplatesResource extends BaseResource<QuoteTemplate, QuoteTe
6669
6938
  queryAll(params?: QuoteTemplatesResourceQueryParams): Promise<QuoteTemplate[]>;
6670
6939
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6671
6940
  count(params?: QuoteTemplatesResourceQueryParams): Promise<number>;
6672
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6673
- 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>;
6674
6945
  /** Resolve a QuoteTemplate from a numeric id (or, where the vendor indexes a primary text field,
6675
6946
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
6676
6947
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -6706,7 +6977,9 @@ declare class ResourceRoleQueuesResource extends BaseResource<ResourceRoleQueue,
6706
6977
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6707
6978
  count(params?: ResourceRoleQueuesResourceQueryParams): Promise<number>;
6708
6979
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/RoleQueues/{id} — vendor item envelope; item: null → NotFoundError). */
6709
- get(parentId: Identifier, id: Identifier): Promise<ResourceRoleQueue>;
6980
+ get(parentId: Identifier, id: Identifier, opts?: {
6981
+ fresh?: boolean;
6982
+ } | null): Promise<ResourceRoleQueue>;
6710
6983
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
6711
6984
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
6712
6985
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -6748,7 +7021,9 @@ declare class ResourceRolesResource extends BaseResource<ResourceRole, ResourceR
6748
7021
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6749
7022
  count(params?: ResourceRolesResourceQueryParams): Promise<number>;
6750
7023
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/Roles/{id} — vendor item envelope; item: null → NotFoundError). */
6751
- get(parentId: Identifier, id: Identifier): Promise<ResourceRole>;
7024
+ get(parentId: Identifier, id: Identifier, opts?: {
7025
+ fresh?: boolean;
7026
+ } | null): Promise<ResourceRole>;
6752
7027
  /** Resolve a ResourceRole from a numeric id (or, where the vendor indexes a primary text field,
6753
7028
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
6754
7029
  * a bare value rejects with a config error (ids only);
@@ -6780,7 +7055,9 @@ declare class ResourceSkillsResource extends BaseResource<ResourceSkill, Resourc
6780
7055
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6781
7056
  count(params?: ResourceSkillsResourceQueryParams): Promise<number>;
6782
7057
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/Skills/{id} — vendor item envelope; item: null → NotFoundError). */
6783
- get(parentId: Identifier, id: Identifier): Promise<ResourceSkill>;
7058
+ get(parentId: Identifier, id: Identifier, opts?: {
7059
+ fresh?: boolean;
7060
+ } | null): Promise<ResourceSkill>;
6784
7061
  /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
6785
7062
  * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
6786
7063
  * the pinned envelope with the best-effort diff; a caller-supplied lastModifiedDate that
@@ -6849,13 +7126,10 @@ declare class ResourcesResource extends BaseResource<Resource, ResourceCreate, R
6849
7126
  queryAll(params?: ResourcesResourceQueryParams): Promise<Resource[]>;
6850
7127
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6851
7128
  count(params?: ResourcesResourceQueryParams): Promise<number>;
6852
- /** Get one record by id (item envelope; item: null → NotFoundError).
6853
- * `fresh: true` in the opts bag bypasses AND refreshes the ReadCache entry for this id
6854
- * (the per-id authority read of operations.expandResourceNames with fresh: true — issue #77);
6855
- * 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). */
6856
7130
  get(id: Identifier, opts?: {
6857
7131
  fresh?: boolean;
6858
- }): Promise<Resource>;
7132
+ } | null): Promise<Resource>;
6859
7133
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
6860
7134
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
6861
7135
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -6936,7 +7210,9 @@ declare class ResourceTimeOffApproversResource extends BaseResource<ResourceTime
6936
7210
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6937
7211
  count(params?: ResourceTimeOffApproversResourceQueryParams): Promise<number>;
6938
7212
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/TimeOffApprovers/{id} — vendor item envelope; item: null → NotFoundError). */
6939
- get(parentId: Identifier, id: Identifier): Promise<ResourceTimeOffApprover>;
7213
+ get(parentId: Identifier, id: Identifier, opts?: {
7214
+ fresh?: boolean;
7215
+ } | null): Promise<ResourceTimeOffApprover>;
6940
7216
  /** Resolve a ResourceTimeOffApprover from a numeric id (or, where the vendor indexes a primary text field,
6941
7217
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
6942
7218
  * a bare value rejects with a config error (ids only);
@@ -6962,7 +7238,9 @@ type ResourceTimeOffBalancesResourceQueryParams = QueryParams;
6962
7238
  declare class ResourceTimeOffBalancesResource extends BaseResource<ResourceTimeOffBalance, ResourceTimeOffBalanceCreate, ResourceTimeOffBalanceUpdate> {
6963
7239
  constructor(http: HttpClient, pageSize: number);
6964
7240
  /** Get one record by parent + id (/V1.0/Resources/{parentId}/TimeOffBalances/{id} — vendor item envelope; item: null → NotFoundError). */
6965
- get(parentId: Identifier, id: Identifier): Promise<ResourceTimeOffBalance>;
7241
+ get(parentId: Identifier, id: Identifier, opts?: {
7242
+ fresh?: boolean;
7243
+ } | null): Promise<ResourceTimeOffBalance>;
6966
7244
  /** Resolve a ResourceTimeOffBalance from a numeric id (or, where the vendor indexes a primary text field,
6967
7245
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
6968
7246
  * a bare value rejects with a config error (ids only);
@@ -6995,8 +7273,10 @@ declare class RolesResource extends BaseResource<Role, RoleCreate, RoleUpdate> {
6995
7273
  queryAll(params?: RolesResourceQueryParams): Promise<Role[]>;
6996
7274
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
6997
7275
  count(params?: RolesResourceQueryParams): Promise<number>;
6998
- /** Get one record by id (item envelope; item: null → NotFoundError). */
6999
- 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>;
7000
7280
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7001
7281
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7002
7282
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7044,8 +7324,10 @@ declare class SalesOrdersResource extends BaseResource<SalesOrder, SalesOrderCre
7044
7324
  queryAll(params?: SalesOrdersResourceQueryParams): Promise<SalesOrder[]>;
7045
7325
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7046
7326
  count(params?: SalesOrdersResourceQueryParams): Promise<number>;
7047
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7048
- 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>;
7049
7331
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
7050
7332
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
7051
7333
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -7074,8 +7356,10 @@ declare class ServiceCallsResource extends BaseResource<ServiceCall, ServiceCall
7074
7356
  queryAll(params?: ServiceCallsResourceQueryParams): Promise<ServiceCall[]>;
7075
7357
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7076
7358
  count(params?: ServiceCallsResourceQueryParams): Promise<number>;
7077
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7078
- 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>;
7079
7363
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7080
7364
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7081
7365
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7125,7 +7409,9 @@ declare class ServiceCallTaskResourcesResource extends BaseResource<ServiceCallT
7125
7409
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7126
7410
  count(params?: ServiceCallTaskResourcesResourceQueryParams): Promise<number>;
7127
7411
  /** Get one record by parent + id (/V1.0/ServiceCallTasks/{parentId}/Resources/{id} — vendor item envelope; item: null → NotFoundError). */
7128
- get(parentId: Identifier, id: Identifier): Promise<ServiceCallTaskResource>;
7412
+ get(parentId: Identifier, id: Identifier, opts?: {
7413
+ fresh?: boolean;
7414
+ } | null): Promise<ServiceCallTaskResource>;
7129
7415
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7130
7416
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7131
7417
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7165,7 +7451,9 @@ declare class ServiceCallTasksResource extends BaseResource<ServiceCallTask, Ser
7165
7451
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7166
7452
  count(params?: ServiceCallTasksResourceQueryParams): Promise<number>;
7167
7453
  /** Get one record by parent + id (/V1.0/ServiceCalls/{parentId}/Tasks/{id} — vendor item envelope; item: null → NotFoundError). */
7168
- get(parentId: Identifier, id: Identifier): Promise<ServiceCallTask>;
7454
+ get(parentId: Identifier, id: Identifier, opts?: {
7455
+ fresh?: boolean;
7456
+ } | null): Promise<ServiceCallTask>;
7169
7457
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7170
7458
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7171
7459
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7205,7 +7493,9 @@ declare class ServiceCallTicketResourcesResource extends BaseResource<ServiceCal
7205
7493
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7206
7494
  count(params?: ServiceCallTicketResourcesResourceQueryParams): Promise<number>;
7207
7495
  /** Get one record by parent + id (/V1.0/ServiceCallTickets/{parentId}/Resources/{id} — vendor item envelope; item: null → NotFoundError). */
7208
- get(parentId: Identifier, id: Identifier): Promise<ServiceCallTicketResource>;
7496
+ get(parentId: Identifier, id: Identifier, opts?: {
7497
+ fresh?: boolean;
7498
+ } | null): Promise<ServiceCallTicketResource>;
7209
7499
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7210
7500
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7211
7501
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7245,7 +7535,9 @@ declare class ServiceCallTicketsResource extends BaseResource<ServiceCallTicket,
7245
7535
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7246
7536
  count(params?: ServiceCallTicketsResourceQueryParams): Promise<number>;
7247
7537
  /** Get one record by parent + id (/V1.0/ServiceCalls/{parentId}/Tickets/{id} — vendor item envelope; item: null → NotFoundError). */
7248
- get(parentId: Identifier, id: Identifier): Promise<ServiceCallTicket>;
7538
+ get(parentId: Identifier, id: Identifier, opts?: {
7539
+ fresh?: boolean;
7540
+ } | null): Promise<ServiceCallTicket>;
7249
7541
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7250
7542
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7251
7543
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7282,8 +7574,10 @@ declare class ServiceLevelAgreementResultsResource extends BaseResource<ServiceL
7282
7574
  queryAll(params?: ServiceLevelAgreementResultsResourceQueryParams): Promise<ServiceLevelAgreementResults[]>;
7283
7575
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7284
7576
  count(params?: ServiceLevelAgreementResultsResourceQueryParams): Promise<number>;
7285
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7286
- 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>;
7287
7581
  /** Resolve a ServiceLevelAgreementResults from a numeric id (or, where the vendor indexes a primary text field,
7288
7582
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7289
7583
  * a bare value rejects with a config error (ids only);
@@ -7312,8 +7606,10 @@ declare class ServicesResource extends BaseResource<Service, ServiceCreate, Serv
7312
7606
  queryAll(params?: ServicesResourceQueryParams): Promise<Service[]>;
7313
7607
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7314
7608
  count(params?: ServicesResourceQueryParams): Promise<number>;
7315
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7316
- 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>;
7317
7613
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7318
7614
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7319
7615
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7361,8 +7657,10 @@ declare class SkillsResource extends BaseResource<Skill, SkillCreate, SkillUpdat
7361
7657
  queryAll(params?: SkillsResourceQueryParams): Promise<Skill[]>;
7362
7658
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7363
7659
  count(params?: SkillsResourceQueryParams): Promise<number>;
7364
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7365
- 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>;
7366
7664
  /** Resolve a Skill from a numeric id (or, where the vendor indexes a primary text field,
7367
7665
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
7368
7666
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -7395,8 +7693,10 @@ declare class SubscriptionPeriodsResource extends BaseResource<SubscriptionPerio
7395
7693
  queryAll(params?: SubscriptionPeriodsResourceQueryParams): Promise<SubscriptionPeriod[]>;
7396
7694
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7397
7695
  count(params?: SubscriptionPeriodsResourceQueryParams): Promise<number>;
7398
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7399
- 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>;
7400
7700
  /** Resolve a SubscriptionPeriod from a numeric id (or, where the vendor indexes a primary text field,
7401
7701
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7402
7702
  * a bare value rejects with a config error (ids only);
@@ -7425,8 +7725,10 @@ declare class SubscriptionsResource extends BaseResource<Subscription, Subscript
7425
7725
  queryAll(params?: SubscriptionsResourceQueryParams): Promise<Subscription[]>;
7426
7726
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7427
7727
  count(params?: SubscriptionsResourceQueryParams): Promise<number>;
7428
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7429
- 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>;
7430
7732
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7431
7733
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7432
7734
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7473,8 +7775,10 @@ declare class SurveyResultsResource extends BaseResource<SurveyResults, SurveyRe
7473
7775
  queryAll(params?: SurveyResultsResourceQueryParams): Promise<SurveyResults[]>;
7474
7776
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7475
7777
  count(params?: SurveyResultsResourceQueryParams): Promise<number>;
7476
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7477
- 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>;
7478
7782
  /** Resolve a SurveyResults from a numeric id (or, where the vendor indexes a primary text field,
7479
7783
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7480
7784
  * a bare value rejects with a config error (ids only);
@@ -7503,8 +7807,10 @@ declare class SurveysResource extends BaseResource<Survey, SurveyCreate, SurveyU
7503
7807
  queryAll(params?: SurveysResourceQueryParams): Promise<Survey[]>;
7504
7808
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7505
7809
  count(params?: SurveysResourceQueryParams): Promise<number>;
7506
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7507
- 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>;
7508
7814
  /** Resolve a Survey from a numeric id (or, where the vendor indexes a primary text field,
7509
7815
  * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
7510
7816
  * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
@@ -7540,7 +7846,9 @@ declare class TagAliasesResource extends BaseResource<TagAlias, TagAliasCreate,
7540
7846
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7541
7847
  count(params?: TagAliasesResourceQueryParams): Promise<number>;
7542
7848
  /** Get one record by parent + id (/V1.0/Tags/{parentId}/Aliases/{id} — vendor item envelope; item: null → NotFoundError). */
7543
- get(parentId: Identifier, id: Identifier): Promise<TagAlias>;
7849
+ get(parentId: Identifier, id: Identifier, opts?: {
7850
+ fresh?: boolean;
7851
+ } | null): Promise<TagAlias>;
7544
7852
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7545
7853
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7546
7854
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7577,8 +7885,10 @@ declare class TagGroupsResource extends BaseResource<TagGroup, TagGroupCreate, T
7577
7885
  queryAll(params?: TagGroupsResourceQueryParams): Promise<TagGroup[]>;
7578
7886
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7579
7887
  count(params?: TagGroupsResourceQueryParams): Promise<number>;
7580
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7581
- 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>;
7582
7892
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7583
7893
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7584
7894
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7625,8 +7935,10 @@ declare class TagsResource extends BaseResource<Tag, TagCreate, TagUpdate> {
7625
7935
  queryAll(params?: TagsResourceQueryParams): Promise<Tag[]>;
7626
7936
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7627
7937
  count(params?: TagsResourceQueryParams): Promise<number>;
7628
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7629
- 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>;
7630
7942
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7631
7943
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7632
7944
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7676,7 +7988,9 @@ declare class TaskSecondaryResourcesResource extends BaseResource<TaskSecondaryR
7676
7988
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7677
7989
  count(params?: TaskSecondaryResourcesResourceQueryParams): Promise<number>;
7678
7990
  /** Get one record by parent + id (/V1.0/Tasks/{parentId}/SecondaryResources/{id} — vendor item envelope; item: null → NotFoundError). */
7679
- get(parentId: Identifier, id: Identifier): Promise<TaskSecondaryResource>;
7991
+ get(parentId: Identifier, id: Identifier, opts?: {
7992
+ fresh?: boolean;
7993
+ } | null): Promise<TaskSecondaryResource>;
7680
7994
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7681
7995
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7682
7996
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7716,7 +8030,9 @@ declare class TasksResource extends BaseResource<Task, TaskCreate, TaskUpdate> {
7716
8030
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7717
8031
  count(params?: TasksResourceQueryParams): Promise<number>;
7718
8032
  /** Get one record by parent + id (/V1.0/Projects/{parentId}/Tasks/{id} — vendor item envelope; item: null → NotFoundError). */
7719
- get(parentId: Identifier, id: Identifier): Promise<Task>;
8033
+ get(parentId: Identifier, id: Identifier, opts?: {
8034
+ fresh?: boolean;
8035
+ } | null): Promise<Task>;
7720
8036
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7721
8037
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7722
8038
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7759,8 +8075,10 @@ declare class TaxRegionsResource extends BaseResource<TaxRegion, TaxRegionCreate
7759
8075
  queryAll(params?: TaxRegionsResourceQueryParams): Promise<TaxRegion[]>;
7760
8076
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7761
8077
  count(params?: TaxRegionsResourceQueryParams): Promise<number>;
7762
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7763
- 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>;
7764
8082
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
7765
8083
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7766
8084
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7812,7 +8130,9 @@ declare class TicketAdditionalConfigurationItemsResource extends BaseResource<Ti
7812
8130
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7813
8131
  count(params?: TicketAdditionalConfigurationItemsResourceQueryParams): Promise<number>;
7814
8132
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/AdditionalConfigurationItems/{id} — vendor item envelope; item: null → NotFoundError). */
7815
- get(parentId: Identifier, id: Identifier): Promise<TicketAdditionalConfigurationItem>;
8133
+ get(parentId: Identifier, id: Identifier, opts?: {
8134
+ fresh?: boolean;
8135
+ } | null): Promise<TicketAdditionalConfigurationItem>;
7816
8136
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7817
8137
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7818
8138
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7852,7 +8172,9 @@ declare class TicketAdditionalContactsResource extends BaseResource<TicketAdditi
7852
8172
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7853
8173
  count(params?: TicketAdditionalContactsResourceQueryParams): Promise<number>;
7854
8174
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/AdditionalContacts/{id} — vendor item envelope; item: null → NotFoundError). */
7855
- get(parentId: Identifier, id: Identifier): Promise<TicketAdditionalContact>;
8175
+ get(parentId: Identifier, id: Identifier, opts?: {
8176
+ fresh?: boolean;
8177
+ } | null): Promise<TicketAdditionalContact>;
7856
8178
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7857
8179
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7858
8180
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7892,7 +8214,9 @@ declare class TicketAttachmentsResource extends BaseResource<TicketAttachment, T
7892
8214
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7893
8215
  count(params?: TicketAttachmentsResourceQueryParams): Promise<number>;
7894
8216
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Attachments/{id} — vendor answers the model directly). */
7895
- get(parentId: Identifier, id: Identifier): Promise<TicketAttachment>;
8217
+ get(parentId: Identifier, id: Identifier, opts?: {
8218
+ fresh?: boolean;
8219
+ } | null): Promise<TicketAttachment>;
7896
8220
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
7897
8221
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
7898
8222
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -7931,8 +8255,10 @@ declare class TicketCategoriesResource extends BaseResource<TicketCategory, Tick
7931
8255
  queryAll(params?: TicketCategoriesResourceQueryParams): Promise<TicketCategory[]>;
7932
8256
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7933
8257
  count(params?: TicketCategoriesResourceQueryParams): Promise<number>;
7934
- /** Get one record by id (item envelope; item: null → NotFoundError). */
7935
- 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>;
7936
8262
  /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
7937
8263
  * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
7938
8264
  * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
@@ -7978,7 +8304,9 @@ declare class TicketCategoryFieldDefaultsResource extends BaseResource<TicketCat
7978
8304
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
7979
8305
  count(params?: TicketCategoryFieldDefaultsResourceQueryParams): Promise<number>;
7980
8306
  /** Get one record by parent + id (/V1.0/TicketCategories/{parentId}/FieldDefaults/{id} — vendor item envelope; item: null → NotFoundError). */
7981
- get(parentId: Identifier, id: Identifier): Promise<TicketCategoryFieldDefault>;
8307
+ get(parentId: Identifier, id: Identifier, opts?: {
8308
+ fresh?: boolean;
8309
+ } | null): Promise<TicketCategoryFieldDefault>;
7982
8310
  /** Resolve a TicketCategoryFieldDefault from a numeric id (or, where the vendor indexes a primary text field,
7983
8311
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
7984
8312
  * a bare value rejects with a config error (ids only);
@@ -8010,7 +8338,9 @@ declare class TicketChangeRequestApprovalsResource extends BaseResource<TicketCh
8010
8338
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8011
8339
  count(params?: TicketChangeRequestApprovalsResourceQueryParams): Promise<number>;
8012
8340
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/ChangeRequestApprovals/{id} — vendor item envelope; item: null → NotFoundError). */
8013
- get(parentId: Identifier, id: Identifier): Promise<TicketChangeRequestApproval>;
8341
+ get(parentId: Identifier, id: Identifier, opts?: {
8342
+ fresh?: boolean;
8343
+ } | null): Promise<TicketChangeRequestApproval>;
8014
8344
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8015
8345
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8016
8346
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8113,7 +8443,9 @@ declare class TicketChargesResource extends BaseResource<TicketCharge, TicketCha
8113
8443
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8114
8444
  count(params?: TicketChargesResourceQueryParams): Promise<number>;
8115
8445
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
8116
- get(parentId: Identifier, id: Identifier): Promise<TicketCharge>;
8446
+ get(parentId: Identifier, id: Identifier, opts?: {
8447
+ fresh?: boolean;
8448
+ } | null): Promise<TicketCharge>;
8117
8449
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8118
8450
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8119
8451
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8164,7 +8496,9 @@ declare class TicketChecklistItemsResource extends BaseResource<TicketChecklistI
8164
8496
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8165
8497
  count(params?: TicketChecklistItemsResourceQueryParams): Promise<number>;
8166
8498
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/ChecklistItems/{id} — vendor item envelope; item: null → NotFoundError). */
8167
- get(parentId: Identifier, id: Identifier): Promise<TicketChecklistItem>;
8499
+ get(parentId: Identifier, id: Identifier, opts?: {
8500
+ fresh?: boolean;
8501
+ } | null): Promise<TicketChecklistItem>;
8168
8502
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8169
8503
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8170
8504
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8239,8 +8573,10 @@ declare class TicketHistoryResource extends BaseResource<TicketHistory, TicketHi
8239
8573
  queryAll(params?: TicketHistoryResourceQueryParams): Promise<TicketHistory[]>;
8240
8574
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8241
8575
  count(params?: TicketHistoryResourceQueryParams): Promise<number>;
8242
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8243
- 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>;
8244
8580
  /** Resolve a TicketHistory from a numeric id (or, where the vendor indexes a primary text field,
8245
8581
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
8246
8582
  * a bare value rejects with a config error (ids only);
@@ -8272,7 +8608,9 @@ declare class TicketNoteAttachmentsResource extends BaseResource<TicketNoteAttac
8272
8608
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8273
8609
  count(params?: TicketNoteAttachmentsResourceQueryParams): Promise<number>;
8274
8610
  /** Get one record by parent + id (/V1.0/TicketNotes/{parentId}/Attachments/{id} — vendor answers the model directly). */
8275
- get(parentId: Identifier, id: Identifier): Promise<TicketNoteAttachment>;
8611
+ get(parentId: Identifier, id: Identifier, opts?: {
8612
+ fresh?: boolean;
8613
+ } | null): Promise<TicketNoteAttachment>;
8276
8614
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8277
8615
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8278
8616
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8314,7 +8652,9 @@ declare class TicketNotesResource extends BaseResource<TicketNote, TicketNoteCre
8314
8652
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8315
8653
  count(params?: TicketNotesResourceQueryParams): Promise<number>;
8316
8654
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
8317
- get(parentId: Identifier, id: Identifier): Promise<TicketNote>;
8655
+ get(parentId: Identifier, id: Identifier, opts?: {
8656
+ fresh?: boolean;
8657
+ } | null): Promise<TicketNote>;
8318
8658
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8319
8659
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8320
8660
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8355,8 +8695,10 @@ declare class TicketNoteWebhooksResource extends BaseResource<TicketNoteWebhook,
8355
8695
  queryAll(params?: TicketNoteWebhooksResourceQueryParams): Promise<TicketNoteWebhook[]>;
8356
8696
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8357
8697
  count(params?: TicketNoteWebhooksResourceQueryParams): Promise<number>;
8358
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8359
- 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>;
8360
8702
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
8361
8703
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8362
8704
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8410,7 +8752,9 @@ declare class TicketSecondaryResourcesResource extends BaseResource<TicketSecond
8410
8752
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8411
8753
  count(params?: TicketSecondaryResourcesResourceQueryParams): Promise<number>;
8412
8754
  /** Get one record by parent + id (/V1.0/Tickets/{parentId}/SecondaryResources/{id} — vendor item envelope; item: null → NotFoundError). */
8413
- get(parentId: Identifier, id: Identifier): Promise<TicketSecondaryResource>;
8755
+ get(parentId: Identifier, id: Identifier, opts?: {
8756
+ fresh?: boolean;
8757
+ } | null): Promise<TicketSecondaryResource>;
8414
8758
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
8415
8759
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8416
8760
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8709,6 +9053,36 @@ interface TicketsForResourceOptions {
8709
9053
  limit?: number;
8710
9054
  /** Extra Ticket fields on top of the pinned projection (id, ticketNumber, title, status, assignedResourceID, companyID). */
8711
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;
8712
9086
  }
8713
9087
  interface TicketsForResourceResult {
8714
9088
  resourceID: number;
@@ -8776,8 +9150,10 @@ declare class TicketsResource extends BaseResource<Ticket, TicketCreate, TicketU
8776
9150
  queryAll(params?: TicketsResourceQueryParams): Promise<Ticket[]>;
8777
9151
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8778
9152
  count(params?: TicketsResourceQueryParams): Promise<number>;
8779
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8780
- 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>;
8781
9157
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
8782
9158
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8783
9159
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -8841,7 +9217,9 @@ declare class TicketsResource extends BaseResource<Ticket, TicketCreate, TicketU
8841
9217
  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
8842
9218
  statusSemantics(opts?: TicketStatusOptions): Promise<TicketStatusSemantics>;
8843
9219
  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
8844
- 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>;
8845
9223
  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
8846
9224
  lineOfBusiness(ticketId: Identifier, associationId?: Identifier): Promise<TicketLineOfBusinessResult>;
8847
9225
  }
@@ -8864,8 +9242,10 @@ declare class TicketWebhooksResource extends BaseResource<TicketWebhook, TicketW
8864
9242
  queryAll(params?: TicketWebhooksResourceQueryParams): Promise<TicketWebhook[]>;
8865
9243
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
8866
9244
  count(params?: TicketWebhooksResourceQueryParams): Promise<number>;
8867
- /** Get one record by id (item envelope; item: null → NotFoundError). */
8868
- 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>;
8869
9249
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
8870
9250
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
8871
9251
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -9127,8 +9507,10 @@ declare class TimeEntriesResource extends BaseResource<TimeEntry, TimeEntryCreat
9127
9507
  queryAll(params?: TimeEntriesResourceQueryParams): Promise<TimeEntry[]>;
9128
9508
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
9129
9509
  count(params?: TimeEntriesResourceQueryParams): Promise<number>;
9130
- /** Get one record by id (item envelope; item: null → NotFoundError). */
9131
- 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>;
9132
9514
  /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
9133
9515
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
9134
9516
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -9218,7 +9600,9 @@ declare class TimeEntryAttachmentsResource extends BaseResource<TimeEntryAttachm
9218
9600
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
9219
9601
  count(params?: TimeEntryAttachmentsResourceQueryParams): Promise<number>;
9220
9602
  /** Get one record by parent + id (/V1.0/TimeEntries/{parentId}/Attachments/{id} — vendor answers the model directly). */
9221
- get(parentId: Identifier, id: Identifier): Promise<TimeEntryAttachment>;
9603
+ get(parentId: Identifier, id: Identifier, opts?: {
9604
+ fresh?: boolean;
9605
+ } | null): Promise<TimeEntryAttachment>;
9222
9606
  /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
9223
9607
  * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
9224
9608
  * specced envelope runs the plan-pinned marker recovery (issue #13 — one bounded read;
@@ -9257,8 +9641,10 @@ declare class TimeOffRequestsResource extends BaseResource<TimeOffRequest, TimeO
9257
9641
  queryAll(params?: TimeOffRequestsResourceQueryParams): Promise<TimeOffRequest[]>;
9258
9642
  /** Count matching records (queryCount envelope unwrapped to a plain number). */
9259
9643
  count(params?: TimeOffRequestsResourceQueryParams): Promise<number>;
9260
- /** Get one record by id (item envelope; item: null → NotFoundError). */
9261
- 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>;
9262
9648
  /** Resolve a TimeOffRequest from a numeric id (or, where the vendor indexes a primary text field,
9263
9649
  * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
9264
9650
  * a bare value rejects with a config error (ids only);
@@ -9537,4 +9923,4 @@ declare class AutotaskClient {
9537
9923
  }): Promise<PromiseSettledResult<R>[]>;
9538
9924
  }
9539
9925
 
9540
- 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 };