node-autotask 0.9.0 → 0.10.0

package/dist/capabilities.cjs

@@ -2,10 +2,9 @@
 
 
 
-var _chunkLTKMTXURcjs = require('./chunk-LTKMTXUR.cjs');
+var _chunkWTVD2JZNcjs = require('./chunk-WTVD2JZN.cjs');
 
 
 
 
-exports.CAPABILITIES = _chunkLTKMTXURcjs.CAPABILITIES; exports.CAPABILITY_GROUPS = _chunkLTKMTXURcjs.CAPABILITY_GROUPS; exports.CAPABILITY_PLAN_HASHES = _chunkLTKMTXURcjs.CAPABILITY_PLAN_HASHES;
-//# sourceMappingURL=capabilities.cjs.map
+exports.CAPABILITIES = _chunkWTVD2JZNcjs.CAPABILITIES; exports.CAPABILITY_GROUPS = _chunkWTVD2JZNcjs.CAPABILITY_GROUPS; exports.CAPABILITY_PLAN_HASHES = _chunkWTVD2JZNcjs.CAPABILITY_PLAN_HASHES;

package/dist/capabilities.js

@@ -2,10 +2,9 @@ import {
   CAPABILITIES,
   CAPABILITY_GROUPS,
   CAPABILITY_PLAN_HASHES
-} from "./chunk-BZPFDRAE.js";
+} from "./chunk-6KFP5HV3.js";
 export {
   CAPABILITIES,
   CAPABILITY_GROUPS,
   CAPABILITY_PLAN_HASHES
 };
-//# sourceMappingURL=capabilities.js.map

package/dist/{chunk-UYJ5V262.js → chunk-3VB6N44U.js}

@@ -4,34 +4,36 @@ import {
   BLIND_SURFACE_STAMPS,
   BaseResource,
   ConflictError,
-  FIELD_CATALOG_HONESTY_NOTE,
   NotFoundError,
   RELATIONSHIP_MAP,
   ResolutionError,
   StaleObjectError,
+  TICKET_LABEL_FIELDS,
   UNTRUSTED_FIELDS_BY_RESOURCE,
+  addLabelSibling,
+  addNameSibling,
   blindStampFor,
   buildDryRunResult,
   buildFilter,
   clampPageSize,
+  createNamePlan,
   cursorToPath,
   decodeFileData,
-  expandResourceNames,
-  fieldCatalog,
   formatVendorDetail,
   isAutotaskError,
   mergePartialBody,
   parseIdentifier,
   parseVendorErrors,
+  resolveCompositeNames,
   resolveFieldsPreset,
   truncateNoteChars,
   unwrapItem,
   unwrapItems,
   unwrapOperation
-} from "./chunk-UDWV4VVD.js";
+} from "./chunk-HWC2WPX2.js";
 import {
   CAPABILITIES
-} from "./chunk-BZPFDRAE.js";
+} from "./chunk-6KFP5HV3.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {
@@ -820,181 +822,6 @@ var ClassificationIconsResource = class extends BaseResource {
   }
 };
 
-// src/operations/compositeNames.ts
-var DEFAULT_MAX_NAME_READS = 20;
-var TICKET_LABEL_FIELDS = ["status", "priority", "ticketType", "issueType", "subIssueType", "source", "queueID"];
-function isVendorId(value) {
-  if (typeof value === "number") return Number.isSafeInteger(value) && value >= 0;
-  if (typeof value === "string") return /^\d+$/.test(value);
-  return false;
-}
-function createNamePlan(labelFields = []) {
-  const resourceIds = [];
-  const resSeen = /* @__PURE__ */ new Set();
-  const recordFks = [];
-  const fkSeen = /* @__PURE__ */ new Set();
-  return {
-    plan: () => ({ resourceIds, recordFks, labelFields }),
-    addResource: (value) => {
-      if (!isVendorId(value)) return;
-      const k = String(value);
-      if (!resSeen.has(k)) {
-        resSeen.add(k);
-        resourceIds.push(value);
-      }
-    },
-    addFk: (table, value) => {
-      if (!isVendorId(value)) return;
-      const k = `${table}:${String(value)}`;
-      if (!fkSeen.has(k)) {
-        fkSeen.add(k);
-        recordFks.push({ table, id: value });
-      }
-    }
-  };
-}
-function addNameSibling(row, field, resolve) {
-  const value = row[field];
-  if (value === void 0) return;
-  row[`${field}Name`] = isVendorId(value) ? resolve(value) : null;
-}
-function addLabelSibling(row, field, names) {
-  const value = row[field];
-  if (value === void 0) return;
-  row[`${field}Label`] = names.labelFor(field, value);
-}
-var FK_TABLE_PATH = {
-  role: "/V1.0/Roles",
-  billingCode: "/V1.0/BillingCodes",
-  contract: "/V1.0/Contracts"
-};
-var FK_NAME_FIELD = {
-  role: "name",
-  billingCode: "name",
-  contract: "contractName"
-};
-function fkName(record, table) {
-  const value = record[FK_NAME_FIELD[table]];
-  return typeof value === "string" && value.trim() !== "" ? value : null;
-}
-function faultRow(err) {
-  const e = err;
-  return e.httpStatus !== void 0 ? { code: e.code, message: e.message, httpStatus: e.httpStatus } : { code: e.code, message: e.message };
-}
-async function resolveCompositeNames(http, plan, opts = {}) {
-  if (opts.maxNameReads !== void 0 && (!Number.isInteger(opts.maxNameReads) || opts.maxNameReads < 1)) {
-    throw new AutotaskConfigError(`composite names: maxNameReads must be an integer >= 1 (got ${String(opts.maxNameReads)})`);
-  }
-  const budget = Math.min(DEFAULT_MAX_NAME_READS, opts.maxNameReads ?? DEFAULT_MAX_NAME_READS);
-  const client = http.client;
-  if (client === void 0) {
-    throw new AutotaskConfigError("composite names: the transport is not wired to an AutotaskClient (the composite must run through the client)");
-  }
-  const readCache = http.readCache;
-  const nameCache = http.resourceNameCache;
-  const section = { truncated: false, rows: {}, reasons: {} };
-  let remaining = budget;
-  const coldResource = [];
-  for (const id of plan.resourceIds) {
-    if (nameCache !== void 0 && nameCache.get(id) !== void 0) continue;
-    if (readCache !== void 0 && readCache.get(`/V1.0/Resources/${id}`) !== void 0) continue;
-    coldResource.push(id);
-  }
-  const withinBudget = coldResource.slice(0, remaining);
-  const overBudgetResource = coldResource.slice(remaining);
-  remaining -= withinBudget.length;
-  for (const id of overBudgetResource) {
-    section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
-    section.truncated = true;
-  }
-  const overSet = new Set(overBudgetResource.map((id) => String(id)));
-  const opIds = plan.resourceIds.filter((id) => !overSet.has(String(id)));
-  if (opIds.length > 0) {
-    let pass = opIds;
-    if (pass.length > 500) {
-      for (const id of pass.slice(500)) {
-        section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
-        section.truncated = true;
-      }
-      pass = pass.slice(0, 500);
-    }
-    const res = await expandResourceNames(client, pass);
-    for (const r of res.results) {
-      const row = { name: r.name, blind: r.blind, capped: false };
-      if (r.error !== void 0) row.error = faultRow(r.error);
-      section.rows[`resource:${r.id}`] = row;
-    }
-  }
-  const holders = {
-    role: client.roles,
-    billingCode: client.billingCodes,
-    contract: client.contracts
-  };
-  for (const fk of plan.recordFks) {
-    const key = `${fk.table}:${fk.id}`;
-    const cold = readCache === void 0 || readCache.get(`${FK_TABLE_PATH[fk.table]}/${fk.id}`) === void 0;
-    if (cold) {
-      if (remaining < 1) {
-        section.rows[key] = { name: null, blind: false, capped: true };
-        section.truncated = true;
-        continue;
-      }
-      remaining -= 1;
-    }
-    try {
-      const record = await holders[fk.table].get(fk.id);
-      section.rows[key] = { name: fkName(record, fk.table), blind: false, capped: false };
-    } catch (err) {
-      if (err instanceof NotFoundError) {
-        section.rows[key] = { name: null, blind: true, capped: false };
-      } else if (isAutotaskError(err) && err.code !== "ABORTED") {
-        section.rows[key] = { name: null, blind: false, capped: false, error: faultRow(err) };
-      } else {
-        throw err;
-      }
-    }
-  }
-  const picklists = {};
-  if (plan.labelFields.length > 0) {
-    let usable = true;
-    try {
-      const catalog = await fieldCatalog(client, { resources: ["tickets"], labels: true, fields: [...plan.labelFields] });
-      const row = catalog.rows.find((r) => r.resource === "tickets");
-      if (row === void 0 || row.error !== null || row.fields === void 0) {
-        usable = false;
-      } else {
-        for (const f of plan.labelFields) {
-          const frow = row.fields.find((x) => x.name === f);
-          picklists[f] = frow?.picklistValues;
-        }
-      }
-    } catch (err) {
-      if (isAutotaskError(err) && err.code !== "ABORTED") usable = false;
-      else throw err;
-    }
-    if (!usable) for (const f of plan.labelFields) section.reasons[f] = FIELD_CATALOG_HONESTY_NOTE;
-  }
-  return {
-    section,
-    resourceName: (id) => section.rows[`resource:${id}`]?.name ?? null,
-    recordName: (table, id) => section.rows[`${table}:${id}`]?.name ?? null,
-    labelFor: (field, value) => {
-      if (value === null || value === void 0) return null;
-      const values = picklists[field];
-      if (values === void 0) {
-        section.reasons[field] = FIELD_CATALOG_HONESTY_NOTE;
-        return null;
-      }
-      const hit = values.find((v) => String(v.value) === String(value));
-      if (hit === void 0) {
-        section.reasons[field] = FIELD_CATALOG_HONESTY_NOTE;
-        return null;
-      }
-      return typeof hit.label === "string" ? hit.label : null;
-    }
-  };
-}
-
 // src/resources/special/companies.ts
 var DEFAULT_LIMIT2 = 25;
 var MAX_LIMIT2 = 500;
@@ -1092,6 +919,22 @@ async function familyChildPage(http, parentID) {
   const { items, pageDetails } = unwrapItems(res, "companies.search");
   return { rows: items, hasNext: pageDetails.nextPageUrl !== null };
 }
+function assertSearchWithDetailOpts(opts) {
+  if (opts === void 0) return;
+  if (typeof opts !== "object" || opts === null || Array.isArray(opts)) {
+    throw new AutotaskConfigError("companies.searchWithDetail: opts must be an object { limit?: number }", {
+      operation: "companies.searchWithDetail"
+    });
+  }
+  for (const key of Object.keys(opts)) {
+    if (key !== "limit") {
+      throw new AutotaskConfigError(
+        `companies.searchWithDetail: unknown opts key "${key}" \u2014 the bag is closed: limit (includeFamily is a companies.search option)`,
+        { operation: "companies.searchWithDetail" }
+      );
+    }
+  }
+}
 async function searchWithFamily(_resource, query, opts = {}, http) {
   if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
     throw new AutotaskConfigError("companies.search: opts must be an object { limit?: number, includeFamily?: boolean }");
@@ -1640,7 +1483,8 @@ async function unbilledWork(resource, companyId, opts = {}, http) {
       capped: false,
       hasMore: false,
       status: "skipped",
-      note: "skipped: the company (set) has no tickets or tasks in the returned join set \u2014 no tasks/tickets to join against is NOT evidence of no time entries (zero wire)"
+      // joinNotes ride the skipped part too: an empty join set from a PARTIAL read (e.g. a full projects page) is not a true zero
+      note: ["skipped: the company (set) has no tickets or tasks in the returned join set \u2014 no tasks/tickets to join against is NOT evidence of no time entries (zero wire)", ...joinNotes].join(" | ")
     };
   } else {
     const timeConditions = taskCap.ids.length > 0 && ticketCap.ids.length > 0 ? [{ op: "or", items: [{ field: "taskID", op: "in", value: taskCap.ids }, { field: "ticketID", op: "in", value: ticketCap.ids }] }] : taskCap.ids.length > 0 ? [{ field: "taskID", op: "in", value: taskCap.ids }] : [{ field: "ticketID", op: "in", value: ticketCap.ids }];
@@ -1833,6 +1677,13 @@ var CompaniesResource = class extends BaseResource {
   async search(query, opts) {
     return searchWithFamily(this, query, opts, this.http);
   }
+  /** `search` with an empty result explained. Same closed opts discipline as `search`: only `limit` is
+   * accepted here (an unknown key is refused pre-request, zero wire — never silently dropped); the
+   * family block is a `search`-only option. */
+  async searchWithDetail(query, opts = {}) {
+    assertSearchWithDetailOpts(opts);
+    return super.searchWithDetail(query, opts);
+  }
   /** Get the Company with its primary context records in one call (each part a single-record
    * fetch; no sub-lists; absent/dangling references come back null). */
   async getContext(id) {
@@ -11082,4 +10933,3 @@ export {
   VersionResource,
   ZoneInformationResource
 };
-//# sourceMappingURL=chunk-UYJ5V262.js.map