fansunited-data-layer 0.13.0 → 0.14.2

package/api/fansunited/search/index.js

@@ -0,0 +1,308 @@
+import { searchHttp } from "./http.js";
+import { isConfigured, getConfig } from "../../../config/index.js";
+import { transformCompetitionSummary, transformCountrySummary, transformEntity, transformEntitySummary, transformTeamSummary, transformVenueSummary } from "./transformer.js";
+import { cached, cachedBatch } from "../../../cache/cache-manager.js";
+import { memoryStore } from "../../../cache/memory-store.js";
+function hashParams(params) {
+  const sorted = Object.entries(params).filter(([, v]) => v !== void 0).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}=${Array.isArray(v) ? v.join(",") : v}`).join("&");
+  let hash = 0;
+  for (let i = 0; i < sorted.length; i++) {
+    hash = (hash << 5) - hash + sorted.charCodeAt(i) | 0;
+  }
+  return hash.toString(36);
+}
+function cacheIndividualEntities(entities) {
+  for (const entity of entities) {
+    if (entity.id) {
+      memoryStore.set(`entity:${entity.id}`, entity);
+    }
+  }
+}
+function resolveLanguage(options) {
+  if (options?.lang) return options.lang;
+  if (isConfigured()) {
+    const config = getConfig();
+    if (config.fansUnited && "lang" in config.fansUnited && config.fansUnited.lang) {
+      return config.fansUnited.lang;
+    }
+  }
+  return "EN";
+}
+function collectMissingIds(entities) {
+  const missingIds = /* @__PURE__ */ new Set();
+  for (const entity of entities) {
+    const raw = entity;
+    const related = raw.related;
+    if (related) {
+      for (const r of related) {
+        if (!memoryStore.get(`entity:${r.related_id}`)) {
+          missingIds.add(r.related_id);
+        }
+      }
+    }
+    const countryId = raw.country_id;
+    if (countryId && !memoryStore.get(`entity:${countryId}`)) {
+      missingIds.add(countryId);
+    }
+  }
+  return missingIds;
+}
+async function batchFetchAndCache(ids, fetchOptions) {
+  if (ids.size === 0) return [];
+  const response = await searchHttp.get({
+    path: "/v1/entities/search",
+    params: { ids: Array.from(ids) },
+    next: fetchOptions?.next,
+    config: fetchOptions?.config
+  });
+  cacheIndividualEntities(response.data);
+  return response.data;
+}
+async function prefetchRelatedEntities(entities, fetchOptions) {
+  const pass1Ids = collectMissingIds(entities);
+  if (pass1Ids.size === 0) return;
+  try {
+    const fetched = await batchFetchAndCache(pass1Ids, fetchOptions);
+    const pass2Ids = collectMissingIds(fetched);
+    if (pass2Ids.size > 0) {
+      await batchFetchAndCache(pass2Ids, fetchOptions);
+    }
+  } catch {
+  }
+}
+async function prefetchCountries(entities, fetchOptions) {
+  const missingIds = /* @__PURE__ */ new Set();
+  for (const entity of entities) {
+    const raw = entity;
+    const countryId = raw.country_id;
+    if (countryId && !memoryStore.get(`entity:${countryId}`)) {
+      missingIds.add(countryId);
+    }
+    const related = raw.related;
+    if (related) {
+      for (const r of related) {
+        if (r.relationship === "COUNTRY" && !memoryStore.get(`entity:${r.related_id}`)) {
+          missingIds.add(r.related_id);
+        }
+      }
+    }
+  }
+  if (missingIds.size === 0) return;
+  try {
+    await batchFetchAndCache(missingIds, fetchOptions);
+  } catch {
+  }
+}
+async function getFansUnitedSearchEntities(options = {}, config) {
+  const lang = resolveLanguage(options);
+  const params = {
+    query: options.query,
+    content_type: options.contentType,
+    ids: options.ids,
+    limit: options.limit?.toString(),
+    page: options.page?.toString(),
+    mode: options.mode,
+    sport: options.sport,
+    relationship: options.relationship,
+    value: options.value
+  };
+  const cacheKey = `search:entities:${hashParams(params)}`;
+  const result = await cached(
+    cacheKey,
+    "search",
+    () => searchHttp.get({
+      path: "/v1/entities/search",
+      params,
+      next: options.next || config?.next,
+      config: options.config
+    })
+  );
+  cacheIndividualEntities(result.data);
+  await prefetchCountries(result.data, { next: options.next || config?.next, config: options.config });
+  const transformed = result.data.map(
+    (e) => transformEntitySummary(e, lang)
+  );
+  return { data: transformed, pagination: result.meta.pagination };
+}
+async function getFansUnitedEntityById(id, options) {
+  const lang = resolveLanguage(options);
+  const cacheKey = `entity:${id}`;
+  const raw = await cached(cacheKey, "search", async () => {
+    const response = await searchHttp.get({
+      path: "/v1/entities/search",
+      params: { ids: [id] },
+      next: options?.next,
+      config: options?.config
+    });
+    if (!response.data || response.data.length === 0) {
+      throw new Error(`Entity not found: ${id}`);
+    }
+    return response.data[0];
+  });
+  await prefetchRelatedEntities([raw], { next: options?.next, config: options?.config });
+  return transformEntity(raw, lang);
+}
+async function getFansUnitedEntitiesByIds(ids, options) {
+  if (ids.length === 0) return [];
+  const lang = resolveLanguage(options);
+  const resultsMap = await cachedBatch(
+    ids,
+    "search",
+    async (missingIds) => {
+      const response = await searchHttp.get({
+        path: "/v1/entities/search",
+        params: { ids: missingIds },
+        next: options?.next,
+        config: options?.config
+      });
+      const map = /* @__PURE__ */ new Map();
+      for (const entity of response.data) {
+        map.set(entity.id, entity);
+      }
+      return map;
+    },
+    (id) => `entity:${id}`
+  );
+  const rawEntities = ids.map((id) => resultsMap.get(id)).filter((e) => e !== void 0);
+  await prefetchRelatedEntities(rawEntities, { next: options?.next, config: options?.config });
+  return rawEntities.map((e) => transformEntity(e, lang));
+}
+async function getFansUnitedCompetitions(options = {}) {
+  const lang = resolveLanguage(options);
+  const params = {
+    content_type: "competition",
+    query: options.query,
+    limit: options.limit?.toString(),
+    page: options.page?.toString(),
+    sport: options.sport
+  };
+  const cacheKey = `competitions:${hashParams(params)}`;
+  const result = await cached(
+    cacheKey,
+    "competitions",
+    () => searchHttp.get({
+      path: "/v1/entities/search",
+      params,
+      next: options.next,
+      config: options.config
+    })
+  );
+  cacheIndividualEntities(result.data);
+  await prefetchCountries(result.data, { next: options.next, config: options.config });
+  const transformed = result.data.map((e) => transformCompetitionSummary(e, lang));
+  return { data: transformed, pagination: result.meta.pagination };
+}
+async function getFansUnitedTeamsByCountry(countryId, options = {}) {
+  const lang = resolveLanguage(options);
+  const params = {
+    content_type: "team",
+    relationship: "COUNTRY",
+    value: countryId,
+    query: options.query,
+    limit: options.limit?.toString(),
+    page: options.page?.toString(),
+    sport: options.sport
+  };
+  const cacheKey = `teams:country:${countryId}:${hashParams(params)}`;
+  const result = await cached(
+    cacheKey,
+    "teams",
+    () => searchHttp.get({
+      path: "/v1/entities/search",
+      params,
+      next: options.next,
+      config: options.config
+    })
+  );
+  cacheIndividualEntities(result.data);
+  await prefetchCountries(result.data, { next: options.next, config: options.config });
+  const transformed = result.data.map((e) => transformTeamSummary(e, lang));
+  return { data: transformed, pagination: result.meta.pagination };
+}
+async function getFansUnitedTeamsByCompetition(competitionId, options = {}) {
+  const lang = resolveLanguage(options);
+  const params = {
+    content_type: "team",
+    relationship: "COMPETITION",
+    value: competitionId,
+    query: options.query,
+    limit: options.limit?.toString(),
+    page: options.page?.toString(),
+    sport: options.sport
+  };
+  const cacheKey = `teams:competition:${competitionId}:${hashParams(params)}`;
+  const result = await cached(
+    cacheKey,
+    "teams",
+    () => searchHttp.get({
+      path: "/v1/entities/search",
+      params,
+      next: options.next,
+      config: options.config
+    })
+  );
+  cacheIndividualEntities(result.data);
+  await prefetchCountries(result.data, { next: options.next, config: options.config });
+  const transformed = result.data.map((e) => transformTeamSummary(e, lang));
+  return { data: transformed, pagination: result.meta.pagination };
+}
+async function getFansUnitedCountries(options = {}) {
+  const lang = resolveLanguage(options);
+  const params = {
+    content_type: "country",
+    query: options.query,
+    limit: options.limit?.toString(),
+    page: options.page?.toString(),
+    sport: options.sport
+  };
+  const cacheKey = `countries:${hashParams(params)}`;
+  const result = await cached(
+    cacheKey,
+    "countries",
+    () => searchHttp.get({
+      path: "/v1/entities/search",
+      params,
+      next: options.next,
+      config: options.config
+    })
+  );
+  cacheIndividualEntities(result.data);
+  const transformed = result.data.map((e) => transformCountrySummary(e, lang));
+  return { data: transformed, pagination: result.meta.pagination };
+}
+async function getFansUnitedVenues(options = {}) {
+  const lang = resolveLanguage(options);
+  const params = {
+    content_type: "venue",
+    query: options.query,
+    limit: options.limit?.toString(),
+    page: options.page?.toString(),
+    sport: options.sport
+  };
+  const cacheKey = `venues:${hashParams(params)}`;
+  const result = await cached(
+    cacheKey,
+    "venues",
+    () => searchHttp.get({
+      path: "/v1/entities/search",
+      params,
+      next: options.next,
+      config: options.config
+    })
+  );
+  cacheIndividualEntities(result.data);
+  await prefetchCountries(result.data, { next: options.next, config: options.config });
+  const transformed = result.data.map((e) => transformVenueSummary(e, lang));
+  return { data: transformed, pagination: result.meta.pagination };
+}
+export {
+  getFansUnitedCompetitions,
+  getFansUnitedCountries,
+  getFansUnitedEntitiesByIds,
+  getFansUnitedEntityById,
+  getFansUnitedSearchEntities,
+  getFansUnitedTeamsByCompetition,
+  getFansUnitedTeamsByCountry,
+  getFansUnitedVenues
+};
+//# sourceMappingURL=index.js.map

package/api/fansunited/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/lib/api/fansunited/search/index.ts"],"sourcesContent":["/**\n * Fans United Search API - Public functions with caching\n */\n\nimport { searchHttp } from \"./http\";\nimport { cached, cachedBatch, memoryStore } from \"../../../cache\";\nimport { getConfig, isConfigured } from \"../../../config\";\nimport {\n    transformEntity,\n    transformEntitySummary,\n    transformCompetitionSummary,\n    transformTeamSummary,\n    transformCountrySummary,\n    transformVenueSummary,\n} from \"./transformer\";\nimport type { RawCompetition, RawTeam, RawCountry, RawVenue, RawSearchEntityBase, RawRelated } from \"./raw-types\";\nimport type {\n    EntitySearchOptions,\n    GetEntityByIdOptions,\n    GetEntitiesByIdsOptions,\n    GetCompetitionsOptions,\n    GetTeamsByCountryOptions,\n    GetTeamsByCompetitionOptions,\n    GetCountriesOptions,\n    GetVenuesOptions,\n    RawSearchEntity,\n    EntitySearchResponse,\n    PaginatedResult,\n    SearchEntityResult,\n    SearchEntitySummary,\n} from \"./types\";\nimport type { NextCacheOptions } from \"../http\";\nimport type { DataLayerConfig } from \"../../../config\";\nimport type {\n    FUSportsCompetitionSummary,\n    FUSportsTeamSummary,\n    FUSportsCountrySummary,\n    FUSportsVenueSummary,\n} from \"../../../types/canonical/base.types\";\n\nfunction hashParams(params: Record<string, string | string[] | undefined>): string {\n    const sorted = Object.entries(params)\n        .filter(([, v]) => v !== undefined)\n        .sort(([a], [b]) => a.localeCompare(b))\n        .map(([k, v]) => `${k}=${Array.isArray(v) ? v.join(\",\") : v}`)\n        .join(\"&\");\n    // Simple hash — sufficient for cache key uniqueness\n    let hash = 0;\n    for (let i = 0; i < sorted.length; i++) {\n        hash = ((hash << 5) - hash + sorted.charCodeAt(i)) | 0;\n    }\n    return hash.toString(36);\n}\n\n/** Cache individual entities from a search response for later ID lookups */\nfunction cacheIndividualEntities(entities: RawSearchEntity[]): void {\n    for (const entity of entities) {\n        if (entity.id) {\n            memoryStore.set(`entity:${entity.id}`, entity);\n        }\n    }\n}\n\n/**\n * Resolve the language for transformation.\n * Priority: options.lang → config.fansUnited.lang → \"EN\"\n */\nfunction resolveLanguage(options?: { lang?: string }): string {\n    if (options?.lang) return options.lang;\n    if (isConfigured()) {\n        const config = getConfig();\n        if (config.fansUnited && \"lang\" in config.fansUnited && config.fansUnited.lang) {\n            return config.fansUnited.lang;\n        }\n    }\n    return \"EN\";\n}\n\n/**\n * Collect missing related entity IDs (and country_id fields) from raw entities.\n */\nfunction collectMissingIds(entities: RawSearchEntity[]): Set<string> {\n    const missingIds = new Set<string>();\n\n    for (const entity of entities) {\n        const raw = entity as Record<string, unknown>;\n\n        // Collect related IDs\n        const related = raw.related as RawRelated[] | undefined;\n        if (related) {\n            for (const r of related) {\n                if (!memoryStore.get(`entity:${r.related_id}`)) {\n                    missingIds.add(r.related_id);\n                }\n            }\n        }\n\n        // Collect country_id\n        const countryId = raw.country_id as string | undefined;\n        if (countryId && !memoryStore.get(`entity:${countryId}`)) {\n            missingIds.add(countryId);\n        }\n    }\n\n    return missingIds;\n}\n\n/**\n * Batch-fetch entity IDs from the search API and cache the results.\n * Returns the fetched raw entities.\n */\nasync function batchFetchAndCache(\n    ids: Set<string>,\n    fetchOptions?: { next?: NextCacheOptions; config?: DataLayerConfig }\n): Promise<RawSearchEntity[]> {\n    if (ids.size === 0) return [];\n\n    const response = await searchHttp.get<EntitySearchResponse>({\n        path: \"/v1/entities/search\",\n        params: { ids: Array.from(ids) },\n        next: fetchOptions?.next,\n        config: fetchOptions?.config,\n    });\n    cacheIndividualEntities(response.data);\n    return response.data;\n}\n\n/**\n * Collect all related entity IDs (and country_id fields) from raw entities\n * that are not already in cache, then batch-fetch them.\n * Does a two-pass fetch: after the first fetch, checks the newly fetched\n * entities for their own dependencies (e.g. country_ids) and fetches those too.\n */\nasync function prefetchRelatedEntities(\n    entities: RawSearchEntity[],\n    fetchOptions?: { next?: NextCacheOptions; config?: DataLayerConfig }\n): Promise<void> {\n    // Pass 1: fetch related entities and country_ids from top-level entities\n    const pass1Ids = collectMissingIds(entities);\n    if (pass1Ids.size === 0) return;\n\n    try {\n        const fetched = await batchFetchAndCache(pass1Ids, fetchOptions);\n\n        // Pass 2: fetch dependencies of the newly fetched entities\n        // (e.g. country_ids of related competitions/teams)\n        const pass2Ids = collectMissingIds(fetched);\n        if (pass2Ids.size > 0) {\n            await batchFetchAndCache(pass2Ids, fetchOptions);\n        }\n    } catch {\n        // Prefetch is best-effort — if it fails, the transformer\n        // will produce partial results for uncached related entities\n    }\n}\n\n/**\n * Lightweight prefetch — only country_ids (single pass).\n * Used by list/search functions that return summary types.\n */\nasync function prefetchCountries(\n    entities: RawSearchEntity[],\n    fetchOptions?: { next?: NextCacheOptions; config?: DataLayerConfig }\n): Promise<void> {\n    const missingIds = new Set<string>();\n\n    for (const entity of entities) {\n        const raw = entity as Record<string, unknown>;\n\n        const countryId = raw.country_id as string | undefined;\n        if (countryId && !memoryStore.get(`entity:${countryId}`)) {\n            missingIds.add(countryId);\n        }\n\n        // Also check related array for COUNTRY entries\n        const related = raw.related as RawRelated[] | undefined;\n        if (related) {\n            for (const r of related) {\n                if (r.relationship === \"COUNTRY\" && !memoryStore.get(`entity:${r.related_id}`)) {\n                    missingIds.add(r.related_id);\n                }\n            }\n        }\n    }\n\n    if (missingIds.size === 0) return;\n\n    try {\n        await batchFetchAndCache(missingIds, fetchOptions);\n    } catch {\n        // Best-effort — summary transforms will produce partial country data\n    }\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Search entities across all content types.\n * Returns transformed canonical types.\n */\nexport async function getFansUnitedSearchEntities(\n    options: EntitySearchOptions = {},\n    config?: { next?: EntitySearchOptions[\"next\"] }\n): Promise<PaginatedResult<SearchEntitySummary>> {\n    const lang = resolveLanguage(options);\n    const params: Record<string, string | string[] | undefined> = {\n        query: options.query,\n        content_type: options.contentType,\n        ids: options.ids,\n        limit: options.limit?.toString(),\n        page: options.page?.toString(),\n        mode: options.mode,\n        sport: options.sport,\n        relationship: options.relationship,\n        value: options.value,\n    };\n\n    const cacheKey = `search:entities:${hashParams(params)}`;\n\n    const result = await cached<EntitySearchResponse>(cacheKey, \"search\", () =>\n        searchHttp.get<EntitySearchResponse>({\n            path: \"/v1/entities/search\",\n            params,\n            next: options.next || config?.next,\n            config: options.config,\n        })\n    );\n\n    // Side-cache individual entities (raw)\n    cacheIndividualEntities(result.data);\n\n    // Pre-fetch only countries (lightweight, single pass)\n    await prefetchCountries(result.data, { next: options.next || config?.next, config: options.config });\n\n    // Transform each raw entity to its summary type (no related, no providerRef)\n    const transformed = result.data.map((e) =>\n        transformEntitySummary(e as RawSearchEntityBase & Record<string, unknown>, lang)\n    );\n\n    return { data: transformed, pagination: result.meta.pagination };\n}\n\n/**\n * Get a single entity by ID.\n * Returns transformed canonical type.\n */\nexport async function getFansUnitedEntityById(\n    id: string,\n    options?: GetEntityByIdOptions\n): Promise<SearchEntityResult> {\n    const lang = resolveLanguage(options);\n    const cacheKey = `entity:${id}`;\n\n    const raw = await cached<RawSearchEntity>(cacheKey, \"search\", async () => {\n        const response = await searchHttp.get<EntitySearchResponse>({\n            path: \"/v1/entities/search\",\n            params: { ids: [id] },\n            next: options?.next,\n            config: options?.config,\n        });\n\n        if (!response.data || response.data.length === 0) {\n            throw new Error(`Entity not found: ${id}`);\n        }\n\n        return response.data[0];\n    });\n\n    // Pre-fetch related entities for this single entity\n    await prefetchRelatedEntities([raw], { next: options?.next, config: options?.config });\n\n    return transformEntity(raw as RawSearchEntityBase & Record<string, unknown>, lang);\n}\n\n/**\n * Get multiple entities by IDs — smart batch caching.\n * Only fetches uncached IDs from the API.\n * Returns transformed canonical types.\n */\nexport async function getFansUnitedEntitiesByIds(\n    ids: string[],\n    options?: GetEntitiesByIdsOptions\n): Promise<SearchEntityResult[]> {\n    if (ids.length === 0) return [];\n\n    const lang = resolveLanguage(options);\n\n    const resultsMap = await cachedBatch<RawSearchEntity>(\n        ids,\n        \"search\",\n        async (missingIds) => {\n            const response = await searchHttp.get<EntitySearchResponse>({\n                path: \"/v1/entities/search\",\n                params: { ids: missingIds },\n                next: options?.next,\n                config: options?.config,\n            });\n\n            const map = new Map<string, RawSearchEntity>();\n            for (const entity of response.data) {\n                map.set(entity.id, entity);\n            }\n            return map;\n        },\n        (id) => `entity:${id}`\n    );\n\n    // Collect raw entities in order\n    const rawEntities = ids\n        .map((id) => resultsMap.get(id))\n        .filter((e): e is RawSearchEntity => e !== undefined);\n\n    // Pre-fetch related entities\n    await prefetchRelatedEntities(rawEntities, { next: options?.next, config: options?.config });\n\n    return rawEntities.map((e) => transformEntity(e as RawSearchEntityBase & Record<string, unknown>, lang));\n}\n\n/**\n * Get competitions with optional filtering.\n * Returns transformed FUSportsCompetition objects.\n */\nexport async function getFansUnitedCompetitions(\n    options: GetCompetitionsOptions = {}\n): Promise<PaginatedResult<FUSportsCompetitionSummary>> {\n    const lang = resolveLanguage(options);\n    const params: Record<string, string | undefined> = {\n        content_type: \"competition\",\n        query: options.query,\n        limit: options.limit?.toString(),\n        page: options.page?.toString(),\n        sport: options.sport,\n    };\n\n    const cacheKey = `competitions:${hashParams(params)}`;\n\n    const result = await cached<EntitySearchResponse>(cacheKey, \"competitions\", () =>\n        searchHttp.get<EntitySearchResponse>({\n            path: \"/v1/entities/search\",\n            params,\n            next: options.next,\n            config: options.config,\n        })\n    );\n\n    cacheIndividualEntities(result.data);\n    await prefetchCountries(result.data, { next: options.next, config: options.config });\n\n    const transformed = result.data.map((e) => transformCompetitionSummary(e as unknown as RawCompetition, lang));\n\n    return { data: transformed, pagination: result.meta.pagination };\n}\n\n/**\n * Get teams filtered by country.\n * Returns transformed FUSportsTeamCompetitor objects.\n */\nexport async function getFansUnitedTeamsByCountry(\n    countryId: string,\n    options: GetTeamsByCountryOptions = {}\n): Promise<PaginatedResult<FUSportsTeamSummary>> {\n    const lang = resolveLanguage(options);\n    const params: Record<string, string | undefined> = {\n        content_type: \"team\",\n        relationship: \"COUNTRY\",\n        value: countryId,\n        query: options.query,\n        limit: options.limit?.toString(),\n        page: options.page?.toString(),\n        sport: options.sport,\n    };\n\n    const cacheKey = `teams:country:${countryId}:${hashParams(params)}`;\n\n    const result = await cached<EntitySearchResponse>(cacheKey, \"teams\", () =>\n        searchHttp.get<EntitySearchResponse>({\n            path: \"/v1/entities/search\",\n            params,\n            next: options.next,\n            config: options.config,\n        })\n    );\n\n    cacheIndividualEntities(result.data);\n    await prefetchCountries(result.data, { next: options.next, config: options.config });\n\n    const transformed = result.data.map((e) => transformTeamSummary(e as unknown as RawTeam, lang));\n\n    return { data: transformed, pagination: result.meta.pagination };\n}\n\n/**\n * Get teams filtered by competition.\n * Returns transformed FUSportsTeamCompetitor objects.\n */\nexport async function getFansUnitedTeamsByCompetition(\n    competitionId: string,\n    options: GetTeamsByCompetitionOptions = {}\n): Promise<PaginatedResult<FUSportsTeamSummary>> {\n    const lang = resolveLanguage(options);\n    const params: Record<string, string | undefined> = {\n        content_type: \"team\",\n        relationship: \"COMPETITION\",\n        value: competitionId,\n        query: options.query,\n        limit: options.limit?.toString(),\n        page: options.page?.toString(),\n        sport: options.sport,\n    };\n\n    const cacheKey = `teams:competition:${competitionId}:${hashParams(params)}`;\n\n    const result = await cached<EntitySearchResponse>(cacheKey, \"teams\", () =>\n        searchHttp.get<EntitySearchResponse>({\n            path: \"/v1/entities/search\",\n            params,\n            next: options.next,\n            config: options.config,\n        })\n    );\n\n    cacheIndividualEntities(result.data);\n    await prefetchCountries(result.data, { next: options.next, config: options.config });\n\n    const transformed = result.data.map((e) => transformTeamSummary(e as unknown as RawTeam, lang));\n\n    return { data: transformed, pagination: result.meta.pagination };\n}\n\n/**\n * Get countries with optional filtering.\n * Returns transformed FUSportsCountry objects.\n */\nexport async function getFansUnitedCountries(\n    options: GetCountriesOptions = {}\n): Promise<PaginatedResult<FUSportsCountrySummary>> {\n    const lang = resolveLanguage(options);\n    const params: Record<string, string | undefined> = {\n        content_type: \"country\",\n        query: options.query,\n        limit: options.limit?.toString(),\n        page: options.page?.toString(),\n        sport: options.sport,\n    };\n\n    const cacheKey = `countries:${hashParams(params)}`;\n\n    const result = await cached<EntitySearchResponse>(cacheKey, \"countries\", () =>\n        searchHttp.get<EntitySearchResponse>({\n            path: \"/v1/entities/search\",\n            params,\n            next: options.next,\n            config: options.config,\n        })\n    );\n\n    cacheIndividualEntities(result.data);\n\n    const transformed = result.data.map((e) => transformCountrySummary(e as unknown as RawCountry, lang));\n\n    return { data: transformed, pagination: result.meta.pagination };\n}\n\n/**\n * Get venues with optional filtering.\n * Returns transformed FUSportsVenue objects.\n */\nexport async function getFansUnitedVenues(\n    options: GetVenuesOptions = {}\n): Promise<PaginatedResult<FUSportsVenueSummary>> {\n    const lang = resolveLanguage(options);\n    const params: Record<string, string | undefined> = {\n        content_type: \"venue\",\n        query: options.query,\n        limit: options.limit?.toString(),\n        page: options.page?.toString(),\n        sport: options.sport,\n    };\n\n    const cacheKey = `venues:${hashParams(params)}`;\n\n    const result = await cached<EntitySearchResponse>(cacheKey, \"venues\", () =>\n        searchHttp.get<EntitySearchResponse>({\n            path: \"/v1/entities/search\",\n            params,\n            next: options.next,\n            config: options.config,\n        })\n    );\n\n    cacheIndividualEntities(result.data);\n    await prefetchCountries(result.data, { next: options.next, config: options.config });\n\n    const transformed = result.data.map((e) => transformVenueSummary(e as unknown as RawVenue, lang));\n\n    return { data: transformed, pagination: result.meta.pagination };\n}\n\n// Re-export types\nexport type {\n    SearchMode,\n    EntityContentType,\n    EntitySearchOptions,\n    GetEntityByIdOptions,\n    GetEntitiesByIdsOptions,\n    GetCompetitionsOptions,\n    GetTeamsByCountryOptions,\n    GetTeamsByCompetitionOptions,\n    GetCountriesOptions,\n    GetVenuesOptions,\n    RawSearchEntity,\n    EntitySearchResponse,\n    PaginationMeta,\n    PaginatedResult,\n    SearchEntityResult,\n    SearchEntitySummary,\n} from \"./types\";\n"],"names":[],"mappings":"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"}