node-autotask 0.33.0 → 0.34.0

package/dist/{chunk-5DS6F6GF.js → chunk-6ADFCU3I.js}

@@ -41,10 +41,10 @@ import {
   unwrapItems,
   unwrapOperation,
   vendorId
-} from "./chunk-MFDQHFGJ.js";
+} from "./chunk-EZKM4HQ6.js";
 import {
   CAPABILITIES
-} from "./chunk-VKE56TTN.js";
+} from "./chunk-4MUBUSTL.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {
@@ -70,9 +70,9 @@ var AppointmentsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -154,9 +154,9 @@ var BillingCodesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a BillingCode from a numeric id (or, where the vendor indexes a primary text field,
    * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
@@ -197,9 +197,9 @@ var BillingItemApprovalLevelsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -562,9 +562,9 @@ var BillingItemsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -662,9 +662,9 @@ var ChangeRequestLinksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -719,9 +719,9 @@ var ChecklistLibrariesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -794,8 +794,8 @@ var ChecklistLibraryChecklistItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ChecklistLibraries/{parentId}/ChecklistItems/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -857,9 +857,9 @@ var ClassificationIconsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a ClassificationIcon from a numeric id (or, where the vendor indexes a primary text field,
    * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
@@ -1328,8 +1328,14 @@ async function readFields(http, fresh) {
   cache?.set(key, "fields", fields);
   return fields;
 }
-function assumed(excludeStatusIds) {
-  const closedIds = excludeStatusIds === void 0 ? [ASSUMED_CLOSED_STATUS_ID] : [...excludeStatusIds];
+function assumed(allowAssumed, operation) {
+  if (!allowAssumed) {
+    throw new AutotaskError(
+      `${operation}: the tenant Tickets status picklist could not be resolved to a closed set and allowAssumed is false, so the assumed id ${ASSUMED_CLOSED_STATUS_ID} is refused (fix: expose the Tickets field catalog to this API user, or pass excludeStatusIds)`,
+      { code: "STATUS_SEMANTICS_UNRESOLVED", category: "validation", operation }
+    );
+  }
+  const closedIds = [ASSUMED_CLOSED_STATUS_ID];
   return {
     picklist: [],
     closedIds,
@@ -1338,7 +1344,11 @@ function assumed(excludeStatusIds) {
     note: `closed = status ${closedIds.join(", ")} \u2014 ASSUMED, not read from the tenant: the Tickets status picklist could not be resolved, so the historical id ${ASSUMED_CLOSED_STATUS_ID} stands in (fix: expose the Tickets field catalog to this API user, or pass excludeStatusIds)`
   };
 }
-async function resolveTicketStatusSemantics(http, opts = {}) {
+async function resolveTicketStatusSemantics(http, opts = {}, operation = OP) {
+  if (opts.allowAssumed !== void 0 && typeof opts.allowAssumed !== "boolean") {
+    throw new AutotaskConfigError(`${operation}: allowAssumed must be a boolean (got ${JSON.stringify(opts.allowAssumed)})`, { operation });
+  }
+  const allowAssumed = opts.allowAssumed !== false;
   if (opts.excludeStatusIds !== void 0) {
     const closedIds2 = [...new Set(opts.excludeStatusIds.map((id) => Number(id)))];
     if (closedIds2.length === 0 || closedIds2.some((id) => !Number.isSafeInteger(id) || id < 1)) {
@@ -1351,11 +1361,11 @@ async function resolveTicketStatusSemantics(http, opts = {}) {
     fields = await readFields(http, opts.fresh === true);
   } catch (e) {
     if (e instanceof AutotaskError && e.code === "ABORTED") throw e;
-    return assumed();
+    return assumed(allowAssumed, operation);
   }
   const picklist = picklistOf(fields);
   const closedIds = picklist.filter((v) => CLOSED_STATUS_LABELS.includes(v.label.trim().toLowerCase())).map((v) => v.id);
-  if (closedIds.length === 0) return assumed();
+  if (closedIds.length === 0) return assumed(allowAssumed, operation);
   const labels = picklist.filter((v) => closedIds.includes(v.id)).map((v) => `${v.id} ${v.label}`).join(", ");
   return {
     picklist,
@@ -1440,8 +1450,8 @@ async function scopedCompanyQuery(http, path, companyID, limit, includeFields) {
   });
   return project(unwrapItems(res).items, includeFields);
 }
-async function readOpenTickets(http, companyID, ticketLimit, includeFields) {
-  const semantics = await resolveTicketStatusSemantics(http);
+async function readOpenTickets(http, companyID, ticketLimit, includeFields, status = {}) {
+  const semantics = await resolveTicketStatusSemantics(http, status, "companies.fullProfile");
   const openLeaf = openStatusFilter(semantics.closedIds);
   const openRows = await (async () => {
     const res = await http.request({
@@ -1541,7 +1551,10 @@ async function fullProfile(resource, id, opts = {}, http) {
   const contacts = await scopedCompanyQuery(http, "/V1.0/Contacts/query", companyID, contactLimit, proj.contacts);
   const notes = await scopedCompanyQuery(http, "/V1.0/CompanyNotes/query", companyID, noteLimit, proj.notes);
   const projects = await scopedCompanyQuery(http, "/V1.0/Projects/query", companyID, projectLimit, proj.projects);
-  const openTickets = await readOpenTickets(http, companyID, ticketLimit, proj.openTickets);
+  const openTickets = await readOpenTickets(http, companyID, ticketLimit, proj.openTickets, {
+    ...opts.excludeStatusIds === void 0 ? {} : { excludeStatusIds: opts.excludeStatusIds },
+    ...opts.allowAssumed === void 0 ? {} : { allowAssumed: opts.allowAssumed }
+  });
   const result = {
     company,
     locations: { items: locations, capped: locations.length >= locLimit },
@@ -2073,9 +2086,9 @@ var CompaniesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2185,8 +2198,8 @@ var CompanyAlertsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/Alerts/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2252,8 +2265,8 @@ var CompanyLocationsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/Locations/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2324,8 +2337,8 @@ var CompanyNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2387,8 +2400,8 @@ var CompanySiteConfigurationsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/SiteConfigurations/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
    * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
@@ -2439,9 +2452,9 @@ var CompanyWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2514,8 +2527,8 @@ var ConfigurationItemBillingProductAssociationsResource = class extends BaseReso
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/BillingProductAssociations/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2579,9 +2592,9 @@ var ConfigurationItemCategoriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2647,8 +2660,8 @@ var ConfigurationItemCategoryUdfAssociationsResource = class extends BaseResourc
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItemCategories/{parentId}/UdfAssociations/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2713,8 +2726,8 @@ var ConfigurationItemDnsRecordsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/DnsRecords/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Delete a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the pinned
    * envelope and never issues the delete. */
@@ -2762,8 +2775,8 @@ var ConfigurationItemNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2821,8 +2834,8 @@ var ConfigurationItemRelatedItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/RelatedItems/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3040,9 +3053,9 @@ var ConfigurationItemsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3131,8 +3144,8 @@ var ConfigurationItemSslSubjectAlternativeNamesResource = class extends BaseReso
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/SslSubjectAlternativeNames/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
    * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
@@ -3192,9 +3205,9 @@ var ConfigurationItemTypesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3268,9 +3281,9 @@ var ConfigurationItemWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3339,9 +3352,9 @@ var ContactGroupContactsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3396,9 +3409,9 @@ var ContactGroupsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3721,8 +3734,8 @@ var ContactsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/Contacts/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3812,9 +3825,9 @@ var ContactWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3887,8 +3900,8 @@ var ContractBillingRulesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/BillingRules/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3953,8 +3966,8 @@ var ContractBlockHourFactorsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/BlockHourFactors/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4012,8 +4025,8 @@ var ContractBlocksResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Blocks/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4072,8 +4085,8 @@ var ContractChargesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4142,8 +4155,8 @@ var ContractExclusionBillingCodesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ExclusionBillingCodes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4199,8 +4212,8 @@ var ContractExclusionRolesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ExclusionRoles/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4256,8 +4269,8 @@ var ContractExclusionSetExcludedRolesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ContractExclusionSets/{parentId}/ExcludedRoles/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4313,8 +4326,8 @@ var ContractExclusionSetExcludedWorkTypesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ContractExclusionSets/{parentId}/ExcludedWorkTypes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4369,9 +4382,9 @@ var ContractExclusionSetsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4444,8 +4457,8 @@ var ContractMilestonesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Milestones/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4503,8 +4516,8 @@ var ContractNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4562,8 +4575,8 @@ var ContractRatesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Rates/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4621,8 +4634,8 @@ var ContractRetainersResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Retainers/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4680,8 +4693,8 @@ var ContractRoleCostsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/RoleCosts/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4807,8 +4820,8 @@ var ContractServiceBundlesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceBundles/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4866,8 +4879,8 @@ var ContractServiceBundleUnitsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceBundleUnits/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ContractServiceBundleUnit from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -4908,8 +4921,8 @@ var ContractServicesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Services/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4967,8 +4980,8 @@ var ContractServiceUnitsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceUnits/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ContractServiceUnit from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -6474,9 +6487,9 @@ var ContractsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6550,8 +6563,8 @@ var ContractTicketPurchasesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/TicketPurchases/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6608,9 +6621,9 @@ var CountriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -6665,9 +6678,9 @@ var CurrenciesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a Currency from a numeric id (or, where the vendor indexes a primary text field,
    * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
@@ -6711,9 +6724,9 @@ var DepartmentsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6778,9 +6791,9 @@ var DomainRegistrarsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6863,8 +6876,8 @@ var ExpenseItemAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ExpenseItems/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6923,9 +6936,9 @@ var ExpenseItemsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6982,9 +6995,9 @@ var ExpenseReportsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7048,9 +7061,9 @@ var HolidaySetsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7119,8 +7132,8 @@ var HolidaysResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/HolidaySets/{parentId}/Holidays/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7213,9 +7226,9 @@ var InventoryProductsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7349,9 +7362,9 @@ var InvoicesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -7461,9 +7474,9 @@ var InvoiceTemplatesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
 };
 
@@ -7505,9 +7518,9 @@ var NotificationHistoryResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a NotificationHistory from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -7546,9 +7559,9 @@ var OpportunitiesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7611,8 +7624,8 @@ var OpportunityAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Opportunities/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7671,9 +7684,9 @@ var OpportunityCategoriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -7729,9 +7742,9 @@ var OrganizationalLevel1sResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7780,9 +7793,9 @@ var OrganizationalLevel2sResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7831,9 +7844,9 @@ var OrganizationalLevelAssociationsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7884,8 +7897,8 @@ var PhasesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Projects/{parentId}/Phases/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7942,9 +7955,9 @@ var ProductsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8010,8 +8023,8 @@ var ProductVendorsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Products/{parentId}/Vendors/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8070,8 +8083,8 @@ var ProjectChargesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Projects/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8140,8 +8153,8 @@ var ProjectNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Projects/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8198,9 +8211,9 @@ var ProjectsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8289,9 +8302,9 @@ var PurchaseApprovalsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -8345,8 +8358,8 @@ var PurchaseOrderItemReceivingResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/PurchaseOrderItems/{parentId}/Receiving/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8395,8 +8408,8 @@ var PurchaseOrderItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/PurchaseOrders/{parentId}/Items/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8452,9 +8465,9 @@ var PurchaseOrdersResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8517,8 +8530,8 @@ var QuoteItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Quotes/{parentId}/Items/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8588,9 +8601,9 @@ var QuoteLocationsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8651,9 +8664,9 @@ var QuotesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8716,9 +8729,9 @@ var QuoteTemplatesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a QuoteTemplate from a numeric id (or, where the vendor indexes a primary text field,
    * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
@@ -8763,8 +8776,8 @@ var ResourceRoleQueuesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/RoleQueues/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8822,8 +8835,8 @@ var ResourceRolesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/Roles/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ResourceRole from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -8864,8 +8877,8 @@ var ResourceSkillsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/Skills/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
    * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
@@ -9023,12 +9036,9 @@ var ResourcesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError).
-   * `fresh: true` in the opts bag bypasses AND refreshes the ReadCache entry for this id
-   * (the per-id authority read of operations.expandResourceNames with fresh: true — issue #77);
-   * a plain get is the bit-for-bit cached read. */
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, opts.fresh === true);
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -9152,8 +9162,8 @@ var ResourceTimeOffApproversResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/TimeOffApprovers/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ResourceTimeOffApprover from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -9205,8 +9215,8 @@ var ResourceTimeOffBalancesResource = class extends BaseResource {
     }, pageSize);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/TimeOffBalances/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ResourceTimeOffBalance from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -9254,9 +9264,9 @@ var RolesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9320,9 +9330,9 @@ var SalesOrdersResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -9363,9 +9373,9 @@ var ServiceCallsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9434,8 +9444,8 @@ var ServiceCallTaskResourcesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ServiceCallTasks/{parentId}/Resources/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9491,8 +9501,8 @@ var ServiceCallTasksResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ServiceCalls/{parentId}/Tasks/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9548,8 +9558,8 @@ var ServiceCallTicketResourcesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ServiceCallTickets/{parentId}/Resources/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9605,8 +9615,8 @@ var ServiceCallTicketsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ServiceCalls/{parentId}/Tickets/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9658,9 +9668,9 @@ var ServiceLevelAgreementResultsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a ServiceLevelAgreementResults from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -9701,9 +9711,9 @@ var ServicesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9766,9 +9776,9 @@ var SkillsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a Skill from a numeric id (or, where the vendor indexes a primary text field,
    * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
@@ -9809,9 +9819,9 @@ var SubscriptionPeriodsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a SubscriptionPeriod from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -9850,9 +9860,9 @@ var SubscriptionsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9917,9 +9927,9 @@ var SurveyResultsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a SurveyResults from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -9957,9 +9967,9 @@ var SurveysResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a Survey from a numeric id (or, where the vendor indexes a primary text field,
    * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
@@ -10004,8 +10014,8 @@ var TagAliasesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tags/{parentId}/Aliases/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10059,9 +10069,9 @@ var TagGroupsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10128,9 +10138,9 @@ var TagsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10199,8 +10209,8 @@ var TaskSecondaryResourcesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tasks/{parentId}/SecondaryResources/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10257,8 +10267,8 @@ var TasksResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Projects/{parentId}/Tasks/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10318,9 +10328,9 @@ var TaxRegionsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10395,8 +10405,8 @@ var TicketAdditionalConfigurationItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/AdditionalConfigurationItems/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10452,8 +10462,8 @@ var TicketAdditionalContactsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/AdditionalContacts/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10510,8 +10520,8 @@ var TicketAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10570,9 +10580,9 @@ var TicketCategoriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -10630,8 +10640,8 @@ var TicketCategoryFieldDefaultsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/TicketCategories/{parentId}/FieldDefaults/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a TicketCategoryFieldDefault from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -10672,8 +10682,8 @@ var TicketChangeRequestApprovalsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/ChangeRequestApprovals/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10961,8 +10971,8 @@ var TicketChargesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11035,8 +11045,8 @@ var TicketChecklistItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/ChecklistItems/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11157,9 +11167,9 @@ var TicketHistoryResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a TicketHistory from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
@@ -11201,8 +11211,8 @@ var TicketNoteAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/TicketNotes/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11262,8 +11272,8 @@ var TicketNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11322,9 +11332,9 @@ var TicketNoteWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11397,8 +11407,8 @@ var TicketSecondaryResourcesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/SecondaryResources/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -12358,6 +12368,7 @@ var TICKET_CHUNK = 100;
 var LIMIT_DEFAULT = 100;
 var LIMIT_MAX = 500;
 var LINK_READ_CAP = 500;
+var COUNT_LINK_PAGES = 20;
 var TICKET_FIELDS2 = ["id", "ticketNumber", "title", "status", "assignedResourceID", "companyID"];
 function positiveId2(value, name) {
   const n = typeof value === "string" && /^\d+$/.test(value.trim()) ? Number(value) : value;
@@ -12377,6 +12388,24 @@ async function ticketPage(http, filter, maxRecords, fields) {
   const page = unwrapItems(res, OP6);
   return { rows: page.items, more: page.pageDetails.nextPageUrl !== null };
 }
+async function readLinkIds(http, resourceID, maxPages = 1) {
+  const ids2 = /* @__PURE__ */ new Set();
+  let cursor = null;
+  for (let pages = 0; pages < maxPages; pages++) {
+    const res = await http.request({
+      method: "POST",
+      idempotent: true,
+      path: cursor === null ? "/V1.0/TicketSecondaryResources/query" : cursorToPath(http.baseUrl, cursor),
+      body: { MaxRecords: LINK_READ_CAP, filter: [{ field: "resourceID", op: "eq", value: resourceID }], IncludeFields: ["ticketID"] },
+      operation: OP6
+    });
+    const page = unwrapItems(res, OP6);
+    for (const row of page.items) if (typeof row.ticketID === "number") ids2.add(row.ticketID);
+    cursor = page.pageDetails.nextPageUrl;
+    if (cursor === null || page.items.length === 0) return { ids: [...ids2], capped: false };
+  }
+  return { ids: [...ids2], capped: true };
+}
 async function forResource(_resource, resourceIDIn, http, opts = {}) {
   if (opts === null || typeof opts !== "object") throw new AutotaskConfigError(`${OP6}: opts must be an object`, { operation: OP6 });
   const resourceID = positiveId2(resourceIDIn, "resourceID");
@@ -12388,7 +12417,7 @@ async function forResource(_resource, resourceIDIn, http, opts = {}) {
     throw new AutotaskConfigError(`${OP6}: openOnly must be a boolean`, { operation: OP6 });
   }
   const limit = opts.limit === void 0 ? LIMIT_DEFAULT : opts.limit;
-  if (!Number.isInteger(limit) || limit < 1 || limit > LIMIT_MAX) {
+  if (opts.countOnly !== true && (!Number.isInteger(limit) || limit < 1 || limit > LIMIT_MAX)) {
     throw new AutotaskConfigError(`${OP6}: limit must be an integer 1-${LIMIT_MAX} (got ${String(opts.limit)})`, { operation: OP6 });
   }
   const includeFields = opts.includeFields ?? [];
@@ -12397,28 +12426,50 @@ async function forResource(_resource, resourceIDIn, http, opts = {}) {
   }
   const openOnly = opts.openOnly === true;
   const fields = [.../* @__PURE__ */ new Set([...TICKET_FIELDS2, ...includeFields])];
-  const closed = await resolveTicketStatusSemantics(http, opts.excludeStatusIds === void 0 ? {} : { excludeStatusIds: opts.excludeStatusIds });
+  if (opts.countOnly !== void 0 && typeof opts.countOnly !== "boolean") {
+    throw new AutotaskConfigError(`${OP6}: countOnly must be a boolean`, { operation: OP6 });
+  }
+  const closed = await resolveTicketStatusSemantics(
+    http,
+    { ...opts.excludeStatusIds === void 0 ? {} : { excludeStatusIds: opts.excludeStatusIds }, ...opts.allowAssumed === void 0 ? {} : { allowAssumed: opts.allowAssumed } },
+    OP6
+  );
   const closedStatus = { closedIds: closed.closedIds, source: closed.source, note: closed.note };
-  const openLeaf = openOnly ? [openStatusFilter(closed.closedIds)] : [];
+  const openLeaf = openOnly || opts.countOnly === true ? [openStatusFilter(closed.closedIds)] : [];
+  if (opts.countOnly === true) {
+    const primaryCount = scope === "secondary" ? 0 : await _resource.count({ filter: [{ field: "assignedResourceID", op: "eq", value: resourceID }, ...openLeaf] });
+    let secondaryCount = 0;
+    let bothCount = 0;
+    let linkCapped = false;
+    if (scope !== "primary") {
+      const links = await readLinkIds(http, resourceID, COUNT_LINK_PAGES);
+      linkCapped = links.capped;
+      for (let c = 0; c < links.ids.length; c += TICKET_CHUNK) {
+        const chunk = links.ids.slice(c, c + TICKET_CHUNK);
+        const page = await ticketPage(http, [{ field: "id", op: "in", value: chunk }, ...openLeaf], chunk.length, ["id", "status", "assignedResourceID"]);
+        const seen = /* @__PURE__ */ new Set();
+        for (const t of page.rows) {
+          if (typeof t.id !== "number" || seen.has(t.id) || isClosedStatus(t.status, closed.closedIds)) continue;
+          seen.add(t.id);
+          if (scope === "both" && t.assignedResourceID === resourceID) bothCount++;
+        }
+        secondaryCount += seen.size;
+      }
+    }
+    return { resourceID, scope, primary: primaryCount, secondary: secondaryCount, both: bothCount, open: primaryCount + secondaryCount - bothCount, capped: linkCapped, closedStatus };
+  }
   const linkIds = [];
   let capped = false;
   if (scope !== "primary") {
-    const res = await http.request({
-      method: "POST",
-      idempotent: true,
-      path: "/V1.0/TicketSecondaryResources/query",
-      body: { MaxRecords: LINK_READ_CAP, filter: [{ field: "resourceID", op: "eq", value: resourceID }], IncludeFields: ["ticketID"] },
-      operation: OP6
-    });
-    const page = unwrapItems(res, OP6);
-    for (const row of page.items) if (typeof row.ticketID === "number" && !linkIds.includes(row.ticketID)) linkIds.push(row.ticketID);
-    if (page.items.length >= LINK_READ_CAP || page.pageDetails.nextPageUrl !== null) capped = true;
+    const links = await readLinkIds(http, resourceID);
+    linkIds.push(...links.ids);
+    capped = links.capped;
   }
   const primary = /* @__PURE__ */ new Map();
   if (scope !== "secondary") {
-    const page = await ticketPage(http, [{ field: "assignedResourceID", op: "eq", value: resourceID }, ...openLeaf], limit, fields);
-    if (page.more || page.rows.length >= limit) capped = true;
-    for (const t of page.rows) if (typeof t.id === "number") primary.set(t.id, t);
+    const page = await ticketPage(http, [{ field: "assignedResourceID", op: "eq", value: resourceID }, ...openLeaf], Math.min(limit + 1, LIMIT_MAX), fields);
+    if (page.more || page.rows.length > limit) capped = true;
+    for (const t of page.rows.slice(0, limit)) if (typeof t.id === "number") primary.set(t.id, t);
   }
   const secondary = /* @__PURE__ */ new Map();
   const unresolvedIds = [];
@@ -12431,7 +12482,14 @@ async function forResource(_resource, resourceIDIn, http, opts = {}) {
       secondary.set(t.id, t);
       seen.add(t.id);
     }
-    for (const id of chunk) if (!seen.has(id)) unresolvedIds.push(id);
+    const missing = chunk.filter((id) => !seen.has(id));
+    if (missing.length > 0 && openOnly) {
+      const found = await ticketPage(http, [{ field: "id", op: "in", value: missing }], missing.length, ["id"]);
+      const closedHere = new Set(found.rows.map((t) => t.id));
+      for (const id of missing) if (!closedHere.has(id)) unresolvedIds.push(id);
+    } else {
+      unresolvedIds.push(...missing);
+    }
   }
   const merged = /* @__PURE__ */ new Map();
   for (const [id, t] of primary) merged.set(id, t);
@@ -12556,9 +12614,9 @@ var TicketsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -12640,7 +12698,6 @@ var TicketsResource = class extends BaseResource {
   statusSemantics(opts) {
     return statusSemantics(this, opts, this.http);
   }
-  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
   forResource(resourceID, opts) {
     return forResource(this, resourceID, this.http, opts);
   }
@@ -12677,9 +12734,9 @@ var TicketWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -13536,9 +13593,9 @@ var TimeEntriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -13688,8 +13745,8 @@ var TimeEntryAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/TimeEntries/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -13795,9 +13852,9 @@ var TimeOffRequestsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
+  async get(id, opts = {}) {
+    return this.getGlobal(id, opts?.fresh === true);
   }
   /** Resolve a TimeOffRequest from a numeric id (or, where the vendor indexes a primary text field,
    * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;