@asd20/ui-next 2.2.2 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+# [2.3.0](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.2.2...ui-next-v2.3.0) (2026-04-13)
+
+
+### Features
+
+* harden search functions for events, page, messages, etc. ([5c9893b](https://github.com/academydistrict20/asd20-ui-next/commit/5c9893b1c943ce1df54c35c97fc0d14b42c72221))
+
 ## [2.2.2](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.2.1...ui-next-v2.2.2) (2026-04-13)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asd20/ui-next",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "private": false,
   "description": "ASD20 UI component library for Vue 3.",
   "license": "MIT",

package/src/components/templates/Asd20404Template/index.vue

@@ -86,6 +86,50 @@ import pageTemplateMixin from '../../../mixins/pageTemplateMixin'
 
 // import Asd20PageContent from '../../../components/organisms/Asd20PageContent'
 
+const MAX_SUGGESTED_PAGES = 10
+const NO_PAGE_RESULTS_FALLBACKS = [
+  {
+    id: 'calendar',
+    slug: 'calendar',
+    title: 'Calendar',
+    url: '/calendar',
+    isNoResultsFallback: true,
+    categories: ['App'],
+    pageTypeId: 'application',
+    metaDescription: 'View district and school calendars.',
+  },
+  {
+    id: 'directory',
+    slug: 'directory',
+    title: 'Directory',
+    url: '/directory',
+    isNoResultsFallback: true,
+    categories: ['App'],
+    pageTypeId: 'application',
+    metaDescription: 'Find staff and department contacts.',
+  },
+  {
+    id: 'school-directory',
+    slug: 'schools',
+    title: 'Schools',
+    url: '/schools',
+    isNoResultsFallback: true,
+    categories: ['App'],
+    pageTypeId: 'application',
+    metaDescription: 'Browse all Academy District 20 schools.',
+  },
+  {
+    id: 'help-desk',
+    slug: 'help-desk',
+    title: 'Help Desk',
+    url: 'https://www.asd20.org/help-desk/',
+    isNoResultsFallback: true,
+    categories: ['Support'],
+    pageTypeId: 'detail-page',
+    metaDescription: 'Get support from the Academy District 20 Help Desk.',
+  },
+]
+
 export default {
   components: {
     Asd20List,
@@ -108,6 +152,83 @@ export default {
   },
 
   methods: {
+    cloneFallbackPages() {
+      return NO_PAGE_RESULTS_FALLBACKS.map(page => ({
+        ...page,
+        categories: Array.isArray(page.categories) ? [...page.categories] : [],
+      }))
+    },
+    normalizeSearchText(value = '') {
+      return String(value)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, ' ')
+        .trim()
+    },
+    getKeywordTokens(keywords = '') {
+      return Array.from(
+        new Set(
+          this.normalizeSearchText(keywords)
+            .split(' ')
+            .filter(token => token.length >= 3)
+        )
+      )
+    },
+    getSuggestedPageDedupKey(page = {}) {
+      const normalizedUrl = this.normalizeSearchText(page.url || '')
+
+      if (normalizedUrl) return `url:${normalizedUrl}`
+
+      const normalizedTitle = this.normalizeSearchText(page.title || '')
+      const normalizedSlug = this.normalizeSearchText(page.slug || '')
+
+      return `title:${normalizedTitle}|slug:${normalizedSlug}`
+    },
+    dedupeSuggestedPages(pages = []) {
+      const seen = new Set()
+
+      return pages.filter(page => {
+        const dedupKey = this.getSuggestedPageDedupKey(page)
+
+        if (!dedupKey || seen.has(dedupKey)) return false
+
+        seen.add(dedupKey)
+        return true
+      })
+    },
+    isRelevantSuggestedPage(page = {}, keywords = '') {
+      if (page.isNoResultsFallback) return true
+
+      const normalizedKeywords = this.normalizeSearchText(keywords)
+      const keywordTokens = this.getKeywordTokens(keywords)
+
+      if (!normalizedKeywords || keywordTokens.length === 0) return false
+
+      const haystack = this.normalizeSearchText([
+        page.title,
+        page.slug,
+        page.url,
+        page.metaDescription,
+        ...(Array.isArray(page.categories) ? page.categories : []),
+      ].join(' '))
+
+      if (!haystack) return false
+      if (haystack.includes(normalizedKeywords)) return true
+
+      return keywordTokens.some(token => haystack.includes(token))
+    },
+    sanitizeSuggestedPages(pages = [], keywords = '') {
+      const dedupedPages = this.dedupeSuggestedPages(
+        Array.isArray(pages) ? pages : []
+      )
+      const relevantPages = dedupedPages.filter(page =>
+        this.isRelevantSuggestedPage(page, keywords)
+      )
+      const resolvedPages = relevantPages.length
+        ? relevantPages
+        : this.cloneFallbackPages()
+
+      return resolvedPages.slice(0, MAX_SUGGESTED_PAGES)
+    },
     async findSuggestedPages() {
       if (typeof window !== 'undefined') {
         const keywords = window.location.pathname
@@ -115,17 +236,16 @@ export default {
           .trim()
           .toLowerCase()
         try {
-          const { pages } = await queryPages({ keywords, top: 4 })
-
-          if (Array.isArray(pages) && pages.length > 0) {
-            this.suggestedPagesListItems = mapPagesToListItems(pages)
-          } else {
-            // console.warn('No pages found or pages is not an array')
-            this.suggestedPagesListItems = []
-          }
+          const { pages } = await queryPages({ keywords, top: MAX_SUGGESTED_PAGES })
+
+          this.suggestedPagesListItems = mapPagesToListItems(
+            this.sanitizeSuggestedPages(pages, keywords)
+          )
         } catch (error) {
           console.error('Error fetching suggested pages:', error)
-          this.suggestedPagesListItems = []
+          this.suggestedPagesListItems = mapPagesToListItems(
+            this.cloneFallbackPages()
+          )
         }
       }
     },

package/src/helpers/buildFileSearchUrl.js

@@ -1,3 +1,5 @@
+import { normalizeBaseUrl, resolveRuntimeConfigValue } from './runtimeConfig'
+
 /**
  * Creates a Azure Search payload
  *
@@ -10,6 +12,11 @@ export default function buildFileSearchUrl({
   owners = [],
   tags = [],
   top = 5,
+  runtimeConfig = null,
+  searchEndpoint = '',
+  endpoint = '',
+  searchKey = '',
+  apiVersion = '',
 }) {
   let query = keywords || '*'
 
@@ -35,21 +42,42 @@ export default function buildFileSearchUrl({
     search: query,
     $filter: filters.join(' and '),
     $top: top,
-    'api-version':
-      process.env.VUE_APP_AZURE_SEARCH_API_VERSION ||
-      process.env.GRIDSOME_AZURE_SEARCH_API_VERSION,
-    'api-key':
-      process.env.VUE_APP_AZURE_SEARCH_KEY ||
-      process.env.GRIDSOME_AZURE_SEARCH_KEY,
+    'api-version': resolveRuntimeConfigValue({
+      explicitValue: apiVersion,
+      runtimeConfig,
+      runtimeConfigKeys: ['azureSearchVersion'],
+      envKeys: [
+        'VUE_APP_AZURE_SEARCH_API_VERSION',
+        'GRIDSOME_AZURE_SEARCH_API_VERSION',
+      ],
+    }),
+    'api-key': resolveRuntimeConfigValue({
+      explicitValue: searchKey,
+      runtimeConfig,
+      runtimeConfigKeys: ['azureSearchKey'],
+      envKeys: ['VUE_APP_AZURE_SEARCH_KEY', 'GRIDSOME_AZURE_SEARCH_KEY'],
+    }),
   }
 
   const params = Object.entries(payload)
     .map(([key, val]) => `${key}=${val}`)
     .join('&')
 
-  let url = `${process.env.VUE_APP_AZURE_SEARCH_ENDPOINT ||
-    process.env
-      .GRIDSOME_AZURE_SEARCH_ENDPOINT}/indexes/files-index/docs?${params}`
+  const resolvedSearchEndpoint = resolveRuntimeConfigValue({
+    explicitValue: searchEndpoint || endpoint,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchEndpoint'],
+    envKeys: ['VUE_APP_AZURE_SEARCH_ENDPOINT', 'GRIDSOME_AZURE_SEARCH_ENDPOINT'],
+  })
+  if (!resolvedSearchEndpoint || !payload['api-version'] || !payload['api-key']) {
+    throw new Error(
+      'Azure Search configuration is required for buildFileSearchUrl.'
+    )
+  }
+
+  let url = `${normalizeBaseUrl(
+    resolvedSearchEndpoint
+  )}/indexes/files-index/docs?${params}`
 
   return url
 }

package/src/helpers/mapPageQueryResultToPageTemplateProps.js

@@ -1,5 +1,7 @@
 import _get from 'lodash/get'
 
+import { resolveRuntimeConfigValue } from './runtimeConfig'
+
 function getConfigurationValueOrDefault({
   configurations,
   category,
@@ -29,7 +31,10 @@ function getConfigurationValueOrDefault({
  * @param {*} queryResult s
  * @returns An object of common prop values for page templates
  */
-export default function mapPageQueryResultToPageTemplateProps(queryResult) {
+export default function mapPageQueryResultToPageTemplateProps(
+  queryResult,
+  options = {}
+) {
   // Ensure query results is defined with required properties
   if (
     !queryResult.page ||
@@ -189,6 +194,14 @@ export default function mapPageQueryResultToPageTemplateProps(queryResult) {
     }
   }
 
+  const defaultOrganizationId =
+    resolveRuntimeConfigValue({
+      explicitValue: options.organizationId,
+      runtimeConfig: options.runtimeConfig,
+      runtimeConfigKeys: ['organizationId'],
+      envKeys: ['GRIDSOME_ORGANIZATION_ID', 'VUE_APP_ORGANIZATION_ID'],
+    }) || '26eaf390-d8ab-11e9-a3a8-5de5bba4f125'
+
   // Output page props
   let pageProps = {}
   try {
@@ -217,11 +230,8 @@ export default function mapPageQueryResultToPageTemplateProps(queryResult) {
         .map(l => l.link)
         .filter(l => l.type === 'Link'),
       organization: pageData.ownerOrganization || {
-        id:
-          process.env.GRIDSOME_ORGANIZATION_ID ||
-          process.env.VUE_APP_ORGANIZATION_ID ||
-          '26eaf390-d8ab-11e9-a3a8-5de5bba4f125', // District Org Id
-        title: 'Academy District 20',
+        id: defaultOrganizationId, // District Org Id
+        title: options.organizationTitle || 'Academy District 20',
       },
 
       // TODO: add groups / department / committee table to Hasura

package/src/helpers/queryDepartments.js

@@ -1,10 +1,9 @@
 import arraySearch from './arraySearch'
 import axios from 'axios'
+import { normalizeBaseUrl, resolveRuntimeConfigValue } from './runtimeConfig'
 // import departments from '../data/departments.json'
 
-const API_ENDPOINT =
-  process.env.VUE_APP_API_ENDPOINT || process.env.GRIDSOME_API_ENDPOINT
-let cachedDepartments = []
+const cachedDepartmentsByEndpoint = new Map()
 
 /**
  * Retrieve departments from API
@@ -13,15 +12,20 @@ let cachedDepartments = []
  * @param {*} { commit }
  * @returns
  */
-async function getDepartments() {
-  if (cachedDepartments.length === 0) {
-    let { data: departments } = await axios.get(
-      `${API_ENDPOINT}/api/departments`
+async function getDepartments(apiEndpoint) {
+  const normalizedApiEndpoint = normalizeBaseUrl(apiEndpoint)
+  if (!normalizedApiEndpoint) {
+    throw new Error('apiEndpoint is required for queryDepartments.')
+  }
+
+  if (!cachedDepartmentsByEndpoint.has(normalizedApiEndpoint)) {
+    const { data: departments } = await axios.get(
+      `${normalizedApiEndpoint}/api/departments`
     )
-    console.log(departments)
-    cachedDepartments = departments
+    cachedDepartmentsByEndpoint.set(normalizedApiEndpoint, departments)
   }
-  return cachedDepartments
+
+  return cachedDepartmentsByEndpoint.get(normalizedApiEndpoint) || []
 }
 
 /**
@@ -29,10 +33,22 @@ async function getDepartments() {
  *
  * @param {*} {keywords = '', top = 0}
  */
-export default async function queryDepartments({ keywords = '', top = 0 }) {
+export default async function queryDepartments({
+  keywords = '',
+  top = 0,
+  apiEndpoint = '',
+  runtimeConfig = null,
+}) {
   if (!keywords) return []
 
-  let departments = await getDepartments()
+  const resolvedApiEndpoint = resolveRuntimeConfigValue({
+    explicitValue: apiEndpoint,
+    runtimeConfig,
+    runtimeConfigKeys: ['apiEndpoint'],
+    envKeys: ['VUE_APP_API_ENDPOINT', 'GRIDSOME_API_ENDPOINT'],
+  })
+
+  let departments = await getDepartments(resolvedApiEndpoint)
 
   let results = departments.filter(d => {
     let options = d.searchTerms

package/src/helpers/queryEvents.js

@@ -1,5 +1,8 @@
 import axios from 'axios'
 
+import { hasSearchProxyRuntime, resolveSearchProxyUrl } from './searchProxyUrl'
+import { normalizeBaseUrl, resolveRuntimeConfigValue } from './runtimeConfig'
+
 /**
  * Creates a Azure Search payload
  *
@@ -73,18 +76,41 @@ export default async function queryEvents({
   limit = 5,
   requireKeywords = false,
   indexName = 'events-index',
+  requestUrl = '',
+  runtimeConfig = null,
+  searchKey = '',
+  apiVersion = '',
+  searchEndpoint = '',
+  endpoint = '',
 }) {
-  const env = {
-    searchKey:
-      process.env.VUE_APP_AZURE_SEARCH_KEY ||
-      process.env.GRIDSOME_AZURE_SEARCH_KEY,
-    apiVersion:
-      process.env.VUE_APP_AZURE_SEARCH_API_VERSION ||
-      process.env.GRIDSOME_AZURE_SEARCH_API_VERSION,
-    endpoint:
-      process.env.VUE_APP_AZURE_SEARCH_ENDPOINT ||
-      process.env.GRIDSOME_AZURE_SEARCH_ENDPOINT,
-  }
+  const resolvedSearchKey = resolveRuntimeConfigValue({
+    explicitValue: searchKey,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchKey'],
+    envKeys: ['VUE_APP_AZURE_SEARCH_KEY', 'GRIDSOME_AZURE_SEARCH_KEY'],
+  })
+  const resolvedApiVersion = resolveRuntimeConfigValue({
+    explicitValue: apiVersion,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchVersion'],
+    envKeys: [
+      'VUE_APP_AZURE_SEARCH_API_VERSION',
+      'GRIDSOME_AZURE_SEARCH_API_VERSION',
+    ],
+  })
+  const resolvedSearchEndpoint = resolveRuntimeConfigValue({
+    explicitValue: searchEndpoint || endpoint,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchEndpoint'],
+    envKeys: ['VUE_APP_AZURE_SEARCH_ENDPOINT', 'GRIDSOME_AZURE_SEARCH_ENDPOINT'],
+  })
+  const resolvedRequestUrl =
+    typeof requestUrl === 'string' && requestUrl.trim()
+      ? requestUrl.trim()
+      : !resolvedSearchEndpoint &&
+        hasSearchProxyRuntime(runtimeConfig)
+      ? resolveSearchProxyUrl('events', runtimeConfig)
+      : ''
 
   if (!keywords && requireKeywords)
     return {
@@ -92,27 +118,49 @@ export default async function queryEvents({
       facets: [],
     }
 
-  let result = await axios({
-    method: 'post',
-    headers: {
-      'api-key': env.searchKey,
-    },
-    params: {
-      'api-version': env.apiVersion,
-    },
-    url: `${env.endpoint}/indexes/${indexName}/docs/search`,
-    data: Object.assign(
-      {},
-      searchPayload({
-        startDate,
-        endDate,
-        keywords,
-        calendarIds,
-        enableFuzzySearch: false,
-        limit,
+  if (
+    !resolvedRequestUrl &&
+    (!resolvedSearchEndpoint || !resolvedSearchKey || !resolvedApiVersion)
+  ) {
+    throw new Error('Azure Search or proxy configuration is required for queryEvents.')
+  }
+
+  const payload = {
+    startDate,
+    endDate,
+    keywords,
+    calendarIds,
+    limit,
+    indexName,
+  }
+
+  const result = resolvedRequestUrl
+    ? await axios({
+        method: 'post',
+        url: resolvedRequestUrl,
+        data: payload,
+      })
+    : await axios({
+        method: 'post',
+        headers: {
+          'api-key': resolvedSearchKey,
+        },
+        params: {
+          'api-version': resolvedApiVersion,
+        },
+        url: `${normalizeBaseUrl(resolvedSearchEndpoint)}/indexes/${indexName}/docs/search`,
+        data: Object.assign(
+          {},
+          searchPayload({
+            startDate,
+            endDate,
+            keywords,
+            calendarIds,
+            enableFuzzySearch: false,
+            limit,
+          })
+        ),
       })
-    ),
-  })
 
   const { data } = result
 

package/src/helpers/queryFiles.js

@@ -1,5 +1,8 @@
 import axios from 'axios'
 
+import { hasSearchProxyRuntime, resolveSearchProxyUrl } from './searchProxyUrl'
+import { normalizeBaseUrl, resolveRuntimeConfigValue } from './runtimeConfig'
+
 /**
  * Creates a Azure Search payload
  *
@@ -64,8 +67,17 @@ export default async function queryFiles({
   keywords = '',
   categories = [],
   owners = [],
+  organizations = [],
   top = 5,
+  limit = 0,
   requireKeywords = false,
+  indexName = 'files-index',
+  requestUrl = '',
+  runtimeConfig = null,
+  searchKey = '',
+  apiVersion = '',
+  searchEndpoint = '',
+  endpoint = '',
 }) {
   if (!keywords && requireKeywords)
     return {
@@ -73,32 +85,81 @@ export default async function queryFiles({
       facets: [],
     }
 
-  let { data } = await axios({
-    method: 'post',
-    headers: {
-      'api-key':
-        process.env.VUE_APP_AZURE_SEARCH_KEY ||
-        process.env.GRIDSOME_AZURE_SEARCH_KEY,
-    },
-    params: {
-      'api-version':
-        process.env.VUE_APP_AZURE_SEARCH_API_VERSION ||
-        process.env.GRIDSOME_AZURE_SEARCH_API_VERSION,
-    },
-    url: `${process.env.VUE_APP_AZURE_SEARCH_ENDPOINT ||
-      process.env
-        .GRIDSOME_AZURE_SEARCH_ENDPOINT}/indexes/files-index/docs/search`,
-    data: Object.assign(
-      {},
-      searchPayload({
-        keywords,
-        categories,
-        owners,
-        enableFuzzySearch: true,
-      }),
-      { top }
-    ),
+  const resolvedLimit = Number.isFinite(Number(limit)) && Number(limit) > 0
+    ? Number(limit)
+    : top
+  const resolvedSearchKey = resolveRuntimeConfigValue({
+    explicitValue: searchKey,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchKey'],
+    envKeys: ['VUE_APP_AZURE_SEARCH_KEY', 'GRIDSOME_AZURE_SEARCH_KEY'],
+  })
+  const resolvedApiVersion = resolveRuntimeConfigValue({
+    explicitValue: apiVersion,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchVersion'],
+    envKeys: [
+      'VUE_APP_AZURE_SEARCH_API_VERSION',
+      'GRIDSOME_AZURE_SEARCH_API_VERSION',
+    ],
   })
+  const resolvedSearchEndpoint = resolveRuntimeConfigValue({
+    explicitValue: searchEndpoint || endpoint,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchEndpoint'],
+    envKeys: ['VUE_APP_AZURE_SEARCH_ENDPOINT', 'GRIDSOME_AZURE_SEARCH_ENDPOINT'],
+  })
+  const resolvedRequestUrl =
+    typeof requestUrl === 'string' && requestUrl.trim()
+      ? requestUrl.trim()
+      : !resolvedSearchEndpoint &&
+        hasSearchProxyRuntime(runtimeConfig)
+      ? resolveSearchProxyUrl('files', runtimeConfig)
+      : ''
+
+  if (
+    !resolvedRequestUrl &&
+    (!resolvedSearchEndpoint || !resolvedSearchKey || !resolvedApiVersion)
+  ) {
+    throw new Error('Azure Search or proxy configuration is required for queryFiles.')
+  }
+
+  const payload = {
+    keywords,
+    categories,
+    owners,
+    organizations,
+    limit: resolvedLimit,
+    indexName,
+  }
+
+  const { data } = resolvedRequestUrl
+    ? await axios({
+        method: 'post',
+        url: resolvedRequestUrl,
+        data: payload,
+      })
+    : await axios({
+        method: 'post',
+        headers: {
+          'api-key': resolvedSearchKey,
+        },
+        params: {
+          'api-version': resolvedApiVersion,
+        },
+        url: `${normalizeBaseUrl(resolvedSearchEndpoint)}/indexes/${indexName}/docs/search`,
+        data: Object.assign(
+          {},
+          searchPayload({
+            keywords,
+            categories,
+            owners,
+            organizations,
+            enableFuzzySearch: true,
+          }),
+          { top: resolvedLimit }
+        ),
+      })
 
   // Return results
   return {

package/src/helpers/queryMessages.js

@@ -1,5 +1,8 @@
 import axios from 'axios'
 
+import { hasSearchProxyRuntime, resolveSearchProxyUrl } from './searchProxyUrl'
+import { normalizeBaseUrl, resolveRuntimeConfigValue } from './runtimeConfig'
+
 /**
  * Creates a Azure Search payload
  *
@@ -83,22 +86,58 @@ export default async function queryMessages({
   organizationIds = [],
   categories = [],
   channels = [],
+  destinationIds = [],
+  destinationTitle = [],
   tags = [],
+  isInLeadershipGroup = false,
   limit = 5,
   requireKeywords = false,
   indexName = 'messages-index',
+  requestUrl = '',
+  runtimeConfig = null,
+  searchKey = '',
+  apiVersion = '',
+  searchEndpoint = '',
+  endpoint = '',
 }) {
-  const env = {
-    searchKey:
-      process.env.VUE_APP_AZURE_SEARCH_MESSAGES_KEY ||
-      process.env.GRIDSOME_AZURE_MESSAGES_SEARCH_KEY,
-    apiVersion:
-      process.env.VUE_APP_AZURE_SEARCH_API_VERSION ||
-      process.env.GRIDSOME_AZURE_SEARCH_API_VERSION,
-    endpoint:
-      process.env.VUE_APP_AZURE_SEARCH_MESSAGES_ENDPOINT ||
-      process.env.GRIDSOME_AZURE_MESSAGES_SEARCH_ENDPOINT,
-  }
+  const resolvedSearchKey = resolveRuntimeConfigValue({
+    explicitValue: searchKey,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchMessagesKey', 'azureSearchKey'],
+    envKeys: [
+      'VUE_APP_AZURE_SEARCH_MESSAGES_KEY',
+      'GRIDSOME_AZURE_MESSAGES_SEARCH_KEY',
+      'VUE_APP_AZURE_SEARCH_KEY',
+      'GRIDSOME_AZURE_SEARCH_KEY',
+    ],
+  })
+  const resolvedApiVersion = resolveRuntimeConfigValue({
+    explicitValue: apiVersion,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchVersion'],
+    envKeys: [
+      'VUE_APP_AZURE_SEARCH_API_VERSION',
+      'GRIDSOME_AZURE_SEARCH_API_VERSION',
+    ],
+  })
+  const resolvedSearchEndpoint = resolveRuntimeConfigValue({
+    explicitValue: searchEndpoint || endpoint,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchMessagesEndpoint', 'azureSearchEndpoint'],
+    envKeys: [
+      'VUE_APP_AZURE_SEARCH_MESSAGES_ENDPOINT',
+      'GRIDSOME_AZURE_MESSAGES_SEARCH_ENDPOINT',
+      'VUE_APP_AZURE_SEARCH_ENDPOINT',
+      'GRIDSOME_AZURE_SEARCH_ENDPOINT',
+    ],
+  })
+  const resolvedRequestUrl =
+    typeof requestUrl === 'string' && requestUrl.trim()
+      ? requestUrl.trim()
+      : !resolvedSearchEndpoint &&
+        hasSearchProxyRuntime(runtimeConfig)
+      ? resolveSearchProxyUrl('messages', runtimeConfig)
+      : ''
 
   if (!keywords && requireKeywords)
     return {
@@ -106,29 +145,57 @@ export default async function queryMessages({
       facets: [],
     }
 
-  let { data } = await axios({
-    method: 'post',
-    headers: {
-      'api-key': env.searchKey,
-    },
-    params: {
-      'api-version': env.apiVersion,
-    },
-    url: `${env.endpoint}/indexes/${indexName}/docs/search`,
-    data: Object.assign(
-      {},
-      searchPayload({
-        keywords,
-        organizationIds,
-        categories,
-        channels,
-        tags,
-        enableFuzzySearch: true,
-        limit,
-      }),
-      { top: limit }
-    ),
-  })
+  if (
+    !resolvedRequestUrl &&
+    (!resolvedSearchEndpoint || !resolvedSearchKey || !resolvedApiVersion)
+  ) {
+    throw new Error(
+      'Azure Search or proxy configuration is required for queryMessages.'
+    )
+  }
+
+  const payload = {
+    keywords,
+    organizationIds,
+    destinationIds,
+    destinationTitle,
+    categories,
+    channels,
+    tags,
+    isInLeadershipGroup,
+    limit,
+    indexName,
+  }
+
+  const { data } = resolvedRequestUrl
+    ? await axios({
+        method: 'post',
+        url: resolvedRequestUrl,
+        data: payload,
+      })
+    : await axios({
+        method: 'post',
+        headers: {
+          'api-key': resolvedSearchKey,
+        },
+        params: {
+          'api-version': resolvedApiVersion,
+        },
+        url: `${normalizeBaseUrl(resolvedSearchEndpoint)}/indexes/${indexName}/docs/search`,
+        data: Object.assign(
+          {},
+          searchPayload({
+            keywords,
+            organizationIds,
+            categories,
+            channels,
+            tags,
+            enableFuzzySearch: true,
+            limit,
+          }),
+          { top: limit }
+        ),
+      })
 
   // Return results
   return {

package/src/helpers/queryPages.js

@@ -1,6 +1,9 @@
 import axios from 'axios'
 
-const NO_PAGE_RESULTS_FALLBACKS = [
+import { hasSearchProxyRuntime, resolveSearchProxyUrl } from './searchProxyUrl'
+import { resolveRuntimeConfigValue } from './runtimeConfig'
+
+export const NO_PAGE_RESULTS_FALLBACKS = [
   {
     id: 'calendar',
     slug: 'calendar',
@@ -106,6 +109,14 @@ export default async function queryPages({
   keywords = '',
   top = 25,
   requireKeywords = false,
+  organizations = [],
+  requestUrl = '',
+  runtimeConfig = null,
+  searchEndpoint = '',
+  endpoint = '',
+  searchKey = '',
+  apiVersion = '',
+  searchVersion = '',
 }) {
   if (!keywords && requireKeywords)
     return {
@@ -113,26 +124,82 @@ export default async function queryPages({
       facets: [],
     }
 
-  let { data } = await axios({
-    method: 'post',
-    headers: {
-      'api-key': process.env.AZURE_SEARCH_KEY,
-    },
-    params: {
-      'api-version': process.env.AZURE_SEARCH_VERSION,
-    },
-    url: `${process.env.AZURE_SEARCH_ENDPOINT}`,
-    data: Object.assign(
-      {},
-      searchPayload({
-        keywords,
-        enableFuzzySearch: true,
-      }),
-      {
-        top,
-      }
-    ),
+  const resolvedSearchKey = resolveRuntimeConfigValue({
+    explicitValue: searchKey,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchKey'],
+    envKeys: [
+      'AZURE_SEARCH_KEY',
+      'VUE_APP_AZURE_SEARCH_KEY',
+      'GRIDSOME_AZURE_SEARCH_KEY',
+    ],
+  })
+  const resolvedApiVersion = resolveRuntimeConfigValue({
+    explicitValue: apiVersion || searchVersion,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchVersion'],
+    envKeys: [
+      'AZURE_SEARCH_VERSION',
+      'VUE_APP_AZURE_SEARCH_API_VERSION',
+      'GRIDSOME_AZURE_SEARCH_API_VERSION',
+    ],
+  })
+  const resolvedSearchEndpoint = resolveRuntimeConfigValue({
+    explicitValue: searchEndpoint || endpoint,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchEndpoint'],
+    envKeys: [
+      'AZURE_SEARCH_ENDPOINT',
+      'VUE_APP_AZURE_SEARCH_ENDPOINT',
+      'GRIDSOME_AZURE_SEARCH_ENDPOINT',
+    ],
   })
+  const resolvedRequestUrl =
+    typeof requestUrl === 'string' && requestUrl.trim()
+      ? requestUrl.trim()
+      : !resolvedSearchEndpoint &&
+        hasSearchProxyRuntime(runtimeConfig)
+      ? resolveSearchProxyUrl('pages', runtimeConfig)
+      : ''
+
+  if (
+    !resolvedRequestUrl &&
+    (!resolvedSearchEndpoint || !resolvedSearchKey || !resolvedApiVersion)
+  ) {
+    throw new Error('Azure Search or proxy configuration is required for queryPages.')
+  }
+
+  const { data } = resolvedRequestUrl
+    ? await axios({
+        method: 'post',
+        url: resolvedRequestUrl,
+        data: {
+          keywords,
+          organizations,
+          top,
+        },
+      })
+    : await axios({
+        method: 'post',
+        headers: {
+          'api-key': resolvedSearchKey,
+        },
+        params: {
+          'api-version': resolvedApiVersion,
+        },
+        url: `${resolvedSearchEndpoint}`,
+        data: Object.assign(
+          {},
+          searchPayload({
+            keywords,
+            enableFuzzySearch: true,
+            organizations,
+          }),
+          {
+            top,
+          }
+        ),
+      })
 
   const pages = Array.isArray(data.value) ? data.value : []
   const resolvedPages = pages.length

package/src/helpers/runtimeConfig.js

@@ -0,0 +1,80 @@
+function isPlainObject(value) {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value)
+}
+
+function normalizeConfigValue(value) {
+  return typeof value === 'string' ? value.trim() : value
+}
+
+function hasConfigValue(value) {
+  if (typeof value === 'string') {
+    return value.trim().length > 0
+  }
+
+  return value !== null && value !== undefined
+}
+
+export function resolvePublicRuntimeConfig(runtimeConfig = {}) {
+  if (!isPlainObject(runtimeConfig)) {
+    return {}
+  }
+
+  if (isPlainObject(runtimeConfig.public)) {
+    return runtimeConfig.public
+  }
+
+  return runtimeConfig
+}
+
+export function resolveWindowPublicRuntimeConfig() {
+  if (typeof window === 'undefined' || !window.__NUXT__) {
+    return {}
+  }
+
+  return resolvePublicRuntimeConfig(window.__NUXT__.config)
+}
+
+export function resolveRuntimeConfigValue({
+  explicitValue = null,
+  runtimeConfig = {},
+  runtimeConfigKeys = [],
+  envKeys = [],
+} = {}) {
+  const normalizedExplicitValue = normalizeConfigValue(explicitValue)
+  if (hasConfigValue(normalizedExplicitValue)) {
+    return normalizedExplicitValue
+  }
+
+  const sources = [
+    resolvePublicRuntimeConfig(runtimeConfig),
+    resolveWindowPublicRuntimeConfig(),
+  ]
+
+  for (const source of sources) {
+    for (const key of runtimeConfigKeys) {
+      const candidate = normalizeConfigValue(source[key])
+      if (hasConfigValue(candidate)) {
+        return candidate
+      }
+    }
+  }
+
+  if (typeof process !== 'undefined' && process && process.env) {
+    for (const key of envKeys) {
+      const candidate = normalizeConfigValue(process.env[key])
+      if (hasConfigValue(candidate)) {
+        return candidate
+      }
+    }
+  }
+
+  return null
+}
+
+export function normalizeBaseUrl(value) {
+  if (typeof value !== 'string') {
+    return ''
+  }
+
+  return value.trim().replace(/\/+$/, '')
+}

package/src/helpers/searchProxyUrl.js

@@ -0,0 +1,43 @@
+import { normalizeBaseUrl, resolveRuntimeConfigValue } from './runtimeConfig'
+
+const SEARCH_PROXY_PATHS = Object.freeze({
+  messages: '/api/search/messages',
+  pages: '/api/search/pages',
+  files: '/api/search/files',
+  events: '/api/search/events',
+})
+
+export function resolveSearchProxyPath(kind) {
+  return SEARCH_PROXY_PATHS[kind] || ''
+}
+
+export function hasSearchProxyRuntime(runtimeConfig = {}) {
+  const functionsEndpoint = resolveRuntimeConfigValue({
+    runtimeConfig,
+    runtimeConfigKeys: ['functionsEndpoint'],
+    envKeys: [],
+  })
+
+  if (functionsEndpoint) {
+    return true
+  }
+
+  return typeof window !== 'undefined' && !!window.__NUXT__
+}
+
+export function resolveSearchProxyUrl(kind, runtimeConfig = {}) {
+  const path = resolveSearchProxyPath(kind)
+
+  if (!path) {
+    throw new Error(`Unknown search proxy kind: ${String(kind)}`)
+  }
+
+  const functionsEndpoint = resolveRuntimeConfigValue({
+    runtimeConfig,
+    runtimeConfigKeys: ['functionsEndpoint'],
+    envKeys: ['FUNCTIONS_ENDPOINT', 'VUE_APP_FUNCTIONS_ENDPOINT'],
+  })
+  const baseUrl = normalizeBaseUrl(functionsEndpoint)
+
+  return baseUrl ? `${baseUrl}${path}` : path
+}

package/src/helpers/sendAccessibilityIssue.js

@@ -1,14 +1,38 @@
 import axios from 'axios'
 
+import { resolveRuntimeConfigValue } from './runtimeConfig'
+
 function issueIsValid(issue) {
   return !!issue.firstName && !!issue.lastName && !!issue.email && !!issue.issue
 }
 
-export default async function sendAccessibilityIssue(issue, endpoint, apiKey, authCode) {
+export default async function sendAccessibilityIssue(
+  issue,
+  endpoint,
+  apiKey,
+  authCode,
+  options = {}
+) {
   if (!issueIsValid(issue)) {
     throw new Error('The issue object is incomplete or invalid.')
   }
 
+  const resolvedOptions =
+    options && typeof options === 'object' && !Array.isArray(options)
+      ? options
+      : {
+          categoryId: options,
+        }
+  const categoryId = resolveRuntimeConfigValue({
+    explicitValue: resolvedOptions.categoryId,
+    runtimeConfig: resolvedOptions.runtimeConfig,
+    runtimeConfigKeys: ['happyFoxCategoryId'],
+    envKeys: ['HAPPYFOX_CATEGORY_ID'],
+  })
+  if (!categoryId) {
+    throw new Error('happyFoxCategoryId is required to send an accessibility issue.')
+  }
+
   const payload = {
     name: `${issue.firstName} ${issue.lastName}`,
     email: issue.email,
@@ -20,7 +44,7 @@ export default async function sendAccessibilityIssue(issue, endpoint, apiKey, au
       <p><strong>Mailing Address:</strong> ${issue.address || 'Not provided'}</p>
       <p><strong>Organization:</strong> ${issue.organization || 'Not provided'}</p>
     `,
-    category: Number(process.env.HAPPYFOX_CATEGORY_ID),
+    category: Number(categoryId),
   }
 
   try {