feat: add CW callback route and optimize cache refresh workflows

src/modules/cache/opportunityCache.ts

@@ -310,25 +310,34 @@ export async function fetchAndCacheCompanyCwData(
   ttlMs: number,
 ): Promise<{ company: any; defaultContact: any; allContacts: any[] } | null> {
   try {
-    const cwCompany = await fetchCwCompanyById(cwCompanyId);
+    // Fetch company and all-contacts in parallel — the allContacts URL
+    // can be constructed directly without the company response.
+    const [cwCompany, allContactsData] = await Promise.all([
+      fetchCwCompanyById(cwCompanyId),
+      withCwRetry(
+        () =>
+          connectWiseApi.get(
+            `/company/companies/${cwCompanyId}/contacts?pageSize=1000`,
+          ),
+        { label: `company#${cwCompanyId}/allContacts` },
+      ),
+    ]);
+
     if (!cwCompany) return null;
 
-    const contactHref = cwCompany.defaultContact?._info?.contact_href;
-    const defaultContactData = contactHref
-      ? await withCwRetry(() => connectWiseApi.get(contactHref), {
-          label: `company#${cwCompanyId}/defaultContact`,
-        })
-      : undefined;
-
-    const allContactsData = await withCwRetry(
-      () =>
-        connectWiseApi.get(`${cwCompany._info.contacts_href}&pageSize=1000`),
-      { label: `company#${cwCompanyId}/allContacts` },
-    );
+    // Default contact: derive from allContacts instead of making an
+    // extra serial CW call.  The company object carries the default
+    // contact's ID, so we can pull it from the list we already fetched.
+    const defaultContactId = cwCompany.defaultContact?.id;
+    const defaultContactData = defaultContactId
+      ? ((allContactsData.data as any[]).find(
+          (c: any) => c.id === defaultContactId,
+        ) ?? null)
+      : null;
 
     const blob = {
       company: cwCompany,
-      defaultContact: defaultContactData?.data ?? null,
+      defaultContact: defaultContactData,
       allContacts: allContactsData.data,
     };
 
@@ -491,11 +500,11 @@ export async function invalidateProductsCache(
 }
 
 /**
- * Site TTL — 30 minutes. Site/address data rarely changes so we cache
+ * Site TTL — 20 minutes. Site/address data rarely changes so we cache
  * aggressively. The background refresh does NOT proactively warm site keys;
  * they are populated lazily on the first detail-view request.
  */
-const SITE_TTL_MS = 1_800_000;
+const SITE_TTL_MS = 1_200_000;
 
 /**
  * Fetch a CW company site from ConnectWise and cache the result.