fansunited-data-layer 0.9.0 → 0.10.0

package/api/fansunited/index.d.ts

@@ -6,5 +6,7 @@
  */
 export { getFansUnitedFootballCompetitions, getFansUnitedFootballCompetition, getFansUnitedFootballTeam, getFansUnitedFootballTeams, getFansUnitedFootballPlayer, getFansUnitedFootballPlayers, getFansUnitedFootballMatch, getFansUnitedFootballMatches, getFansUnitedFootballSearch, } from "./football";
 export type { GetFootballCompetitionsOptions, GetFootballCompetitionOptions, GetFootballTeamOptions, GetFootballTeamsOptions, GetFootballPlayerOptions, GetFootballPlayersOptions, GetFootballMatchOptions, GetFootballMatchesOptions, GetFootballSearchOptions, SearchEntityType, FansUnitedFootballSearchResult, } from "./football";
+export { getFansUnitedSearchEntities, getFansUnitedEntityById, getFansUnitedEntitiesByIds, getFansUnitedCompetitions, getFansUnitedTeamsByCountry, getFansUnitedTeamsByCompetition, getFansUnitedCountries, getFansUnitedVenues, } from "./search";
+export type { SearchMode, EntityContentType, EntitySearchOptions, GetEntityByIdOptions, GetEntitiesByIdsOptions, GetCompetitionsOptions, GetTeamsByCountryOptions, GetTeamsByCompetitionOptions, GetCountriesOptions, GetVenuesOptions, RawSearchEntity, SearchEntityResult, SearchEntitySummary, EntitySearchResponse, PaginationMeta, PaginatedResult, } from "./search";
 export type { NextCacheOptions } from "./http";
 //# sourceMappingURL=index.d.ts.map

package/api/fansunited/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/api/fansunited/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACH,iCAAiC,EACjC,gCAAgC,EAChC,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,GAC9B,MAAM,YAAY,CAAC;AAEpB,YAAY,EACR,8BAA8B,EAC9B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,8BAA8B,GACjC,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/api/fansunited/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACH,iCAAiC,EACjC,gCAAgC,EAChC,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,GAC9B,MAAM,YAAY,CAAC;AAEpB,YAAY,EACR,8BAA8B,EAC9B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,8BAA8B,GACjC,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,mBAAmB,GACtB,MAAM,UAAU,CAAC;AAElB,YAAY,EACR,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,eAAe,GAClB,MAAM,UAAU,CAAC;AAGlB,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC"}

package/api/fansunited/search/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/api/fansunited/search/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../../../src/lib/api/fansunited/search/__tests__/index.test.ts"],"names":[],"mappings":""}

package/api/fansunited/search/__tests__/transformer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transformer.test.d.ts.map

package/api/fansunited/search/__tests__/transformer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.test.d.ts","sourceRoot":"","sources":["../../../../../src/lib/api/fansunited/search/__tests__/transformer.test.ts"],"names":[],"mappings":""}

package/api/fansunited/search/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const FANSUNITED_SEARCH_DOMAIN = "https://search.fansunitedapi.com";
+//# sourceMappingURL=constants.d.ts.map

package/api/fansunited/search/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/fansunited/search/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,qCAAqC,CAAC"}

package/api/fansunited/search/http.d.ts

@@ -0,0 +1,5 @@
+/**
+ * HTTP client for the Fans United Search API
+ */
+export declare const searchHttp: import("../http").FansUnitedHttpClient;
+//# sourceMappingURL=http.d.ts.map

package/api/fansunited/search/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/fansunited/search/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU,wCAA6C,CAAC"}

package/api/fansunited/search/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Fans United Search API - Public functions with caching
+ */
+import type { EntitySearchOptions, GetEntityByIdOptions, GetEntitiesByIdsOptions, GetCompetitionsOptions, GetTeamsByCountryOptions, GetTeamsByCompetitionOptions, GetCountriesOptions, GetVenuesOptions, PaginatedResult, SearchEntityResult, SearchEntitySummary } from "./types";
+import type { FUSportsCompetitionSummary, FUSportsTeamSummary, FUSportsCountrySummary, FUSportsVenueSummary } from "../../../types/canonical/base.types";
+/**
+ * Search entities across all content types.
+ * Returns transformed canonical types.
+ */
+export declare function getFansUnitedSearchEntities(options?: EntitySearchOptions, config?: {
+    next?: EntitySearchOptions["next"];
+}): Promise<PaginatedResult<SearchEntitySummary>>;
+/**
+ * Get a single entity by ID.
+ * Returns transformed canonical type.
+ */
+export declare function getFansUnitedEntityById(id: string, options?: GetEntityByIdOptions): Promise<SearchEntityResult>;
+/**
+ * Get multiple entities by IDs — smart batch caching.
+ * Only fetches uncached IDs from the API.
+ * Returns transformed canonical types.
+ */
+export declare function getFansUnitedEntitiesByIds(ids: string[], options?: GetEntitiesByIdsOptions): Promise<SearchEntityResult[]>;
+/**
+ * Get competitions with optional filtering.
+ * Returns transformed FUSportsCompetition objects.
+ */
+export declare function getFansUnitedCompetitions(options?: GetCompetitionsOptions): Promise<PaginatedResult<FUSportsCompetitionSummary>>;
+/**
+ * Get teams filtered by country.
+ * Returns transformed FUSportsTeamCompetitor objects.
+ */
+export declare function getFansUnitedTeamsByCountry(countryId: string, options?: GetTeamsByCountryOptions): Promise<PaginatedResult<FUSportsTeamSummary>>;
+/**
+ * Get teams filtered by competition.
+ * Returns transformed FUSportsTeamCompetitor objects.
+ */
+export declare function getFansUnitedTeamsByCompetition(competitionId: string, options?: GetTeamsByCompetitionOptions): Promise<PaginatedResult<FUSportsTeamSummary>>;
+/**
+ * Get countries with optional filtering.
+ * Returns transformed FUSportsCountry objects.
+ */
+export declare function getFansUnitedCountries(options?: GetCountriesOptions): Promise<PaginatedResult<FUSportsCountrySummary>>;
+/**
+ * Get venues with optional filtering.
+ * Returns transformed FUSportsVenue objects.
+ */
+export declare function getFansUnitedVenues(options?: GetVenuesOptions): Promise<PaginatedResult<FUSportsVenueSummary>>;
+export type { SearchMode, EntityContentType, EntitySearchOptions, GetEntityByIdOptions, GetEntitiesByIdsOptions, GetCompetitionsOptions, GetTeamsByCountryOptions, GetTeamsByCompetitionOptions, GetCountriesOptions, GetVenuesOptions, RawSearchEntity, EntitySearchResponse, PaginationMeta, PaginatedResult, SearchEntityResult, SearchEntitySummary, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/api/fansunited/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/fansunited/search/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,OAAO,KAAK,EACR,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAGhB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,EACR,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACvB,MAAM,qCAAqC,CAAC;AAgK7C;;;GAGG;AACH,wBAAsB,2BAA2B,CAC7C,OAAO,GAAE,mBAAwB,EACjC,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAA;CAAE,GAChD,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAqC/C;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,oBAAoB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAuB7B;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC5C,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,CAAC,EAAE,uBAAuB,GAClC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkC/B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC3C,OAAO,GAAE,sBAA2B,GACrC,OAAO,CAAC,eAAe,CAAC,0BAA0B,CAAC,CAAC,CA2BtD;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,wBAA6B,GACvC,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CA6B/C;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACjD,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,4BAAiC,GAC3C,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CA6B/C;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CACxC,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC,CA0BlD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,GAAE,gBAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC,CA2BhD;AAGD,YAAY,EACR,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACtB,MAAM,SAAS,CAAC"}

package/api/fansunited/search/raw-types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Raw API response types for the Fans United Search API.
+ * These represent the exact shape returned by the API before transformation.
+ */
+export interface RawTranslation {
+    language: string;
+    name: string;
+    short_name?: string | null;
+}
+export interface RawAsset {
+    key: string;
+    value: string;
+}
+export interface RawRelated {
+    relationship: string;
+    related_id: string;
+}
+export interface RawProviderRef {
+    provider: string;
+    id: string;
+}
+export interface RawBranding {
+    primary_color?: string | null;
+    secondary_color?: string | null;
+    text_color?: string | null;
+    background_color?: string | null;
+    background_gradient_from_color?: string | null;
+    background_gradient_to_color?: string | null;
+    background_image?: string | null;
+}
+export interface RawTeamBranding {
+    primary_color?: string | null;
+    secondary_color?: string | null;
+    tertiary_color?: string | null;
+    text_color?: string | null;
+    background_color?: string | null;
+    background_gradient_from_color?: string | null;
+    background_gradient_to_color?: string | null;
+    background_image?: string | null;
+}
+export interface RawSearchEntityBase {
+    id: string;
+    sport: string;
+    name: string;
+    short_name?: string | null;
+    gender?: string;
+    translations: RawTranslation[];
+    assets: RawAsset[];
+    related: RawRelated[];
+    provider_ref: RawProviderRef[];
+}
+export interface RawCompetition extends RawSearchEntityBase {
+    content_type: "COMPETITION";
+    format?: string;
+    branding?: RawBranding;
+}
+export interface RawTeam extends RawSearchEntityBase {
+    type?: string;
+    full_name?: string | null;
+    three_letter_code?: string | null;
+    nickname?: string | null;
+    country_id?: string | null;
+    metadata?: {
+        branding?: RawTeamBranding;
+    };
+    additional_information?: unknown[];
+}
+export interface RawAthlete extends RawSearchEntityBase {
+    type?: string;
+    position?: string | null;
+    birth_date?: string | null;
+    shirt_number?: number | null;
+    country_id?: string | null;
+    metadata?: {
+        branding?: RawTeamBranding;
+    };
+}
+export interface RawCountry extends RawSearchEntityBase {
+    country_code?: string | null;
+    alias?: string | null;
+}
+export interface RawVenue extends RawSearchEntityBase {
+    capacity?: number | null;
+    latitude?: number | null;
+    longitude?: number | null;
+    country_id?: string | null;
+}
+export interface RawCoach extends RawSearchEntityBase {
+    type?: string;
+    birth_date?: string | null;
+    country_id?: string | null;
+}
+//# sourceMappingURL=raw-types.d.ts.map

package/api/fansunited/search/raw-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-types.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/fansunited/search/raw-types.ts"],"names":[],"mappings":"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"}

package/api/fansunited/search/transformer.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Raw → Canonical transformer for Search API entities.
+ *
+ * Resolves translations to a target language (with EN fallback),
+ * maps raw snake_case fields to canonical camelCase types,
+ * and hydrates related entries (country + related) one level deep from cache.
+ */
+import type { FUSportsCompetition, FUSportsTeamCompetitor, FUSportsPlayerCompetitor, FUSportsCountry, FUSportsVenue, FUSportsCoach, FUSportsRelated, FUBranding, FUSportsCompetitionSummary, FUSportsTeamSummary, FUSportsPlayerSummary, FUSportsCountrySummary, FUSportsVenueSummary, FUSportsCoachSummary } from "../../../types/canonical/base.types";
+import type { SearchEntityResult, SearchEntitySummary } from "./types";
+import type { RawTranslation, RawAsset, RawRelated, RawProviderRef, RawBranding, RawTeamBranding, RawSearchEntityBase, RawCompetition, RawTeam, RawAthlete, RawCountry, RawVenue, RawCoach } from "./raw-types";
+/**
+ * Resolve name/shortName in target language.
+ * Fallback order: target lang → EN → raw name.
+ */
+export declare function resolveTranslation(translations: RawTranslation[], lang: string, fallbackName: string, fallbackShortName?: string | null): {
+    name: string;
+    shortName?: string;
+};
+/**
+ * Map [{key: "LOGO", value: "url"}] → { logo: "url" }
+ */
+export declare function resolveAssets(assets: RawAsset[]): Record<string, string>;
+/**
+ * Map raw branding snake_case → canonical FUBranding camelCase.
+ */
+export declare function resolveBranding(raw: RawBranding | RawTeamBranding | undefined | null): FUBranding | undefined;
+/** Map raw provider_ref → canonical providerRef */
+export declare function resolveProviderRef(refs: RawProviderRef[]): {
+    provider: string;
+    id: string;
+}[];
+/** Extract related IDs by relationship type */
+export declare function getRelatedIds(related: RawRelated[], relationship: string): string[];
+/**
+ * Resolve a country from cache (one level deep).
+ * Returns FUSportsCountry with name in target lang if cached, or { id } if not.
+ */
+export declare function resolveCountry(countryId: string | null | undefined, related: RawRelated[], lang: string): FUSportsCountry | undefined;
+export declare function transformCountrySummary(raw: RawCountry, lang: string): FUSportsCountrySummary;
+export declare function transformCompetitionSummary(raw: RawCompetition, lang: string): FUSportsCompetitionSummary;
+export declare function transformTeamSummary(raw: RawTeam, lang: string): FUSportsTeamSummary;
+export declare function transformAthleteSummary(raw: RawAthlete, lang: string): FUSportsPlayerSummary;
+export declare function transformVenueSummary(raw: RawVenue, lang: string): FUSportsVenueSummary;
+export declare function transformCoachSummary(raw: RawCoach, lang: string): FUSportsCoachSummary;
+/**
+ * Resolve all related entries from cache, grouped by relationship type.
+ * Returns undefined if there are no related entries.
+ */
+export declare function resolveRelated(related: RawRelated[], lang: string): FUSportsRelated | undefined;
+export declare function transformCompetition(raw: RawCompetition, lang: string): FUSportsCompetition;
+export declare function transformTeam(raw: RawTeam, lang: string): FUSportsTeamCompetitor;
+export declare function transformAthlete(raw: RawAthlete, lang: string): FUSportsPlayerCompetitor;
+export declare function transformCountry(raw: RawCountry, lang: string): FUSportsCountry;
+export declare function transformVenue(raw: RawVenue, lang: string): FUSportsVenue;
+export declare function transformCoach(raw: RawCoach, lang: string): FUSportsCoach;
+/**
+ * Determine entity type from raw data and call the appropriate transformer.
+ * The raw API uses `content_type` for competitions and `type` / general context for others.
+ */
+export declare function transformEntity(raw: RawSearchEntityBase & Record<string, unknown>, lang: string): SearchEntityResult;
+/**
+ * Summary dispatcher — like transformEntity but calls summary transforms.
+ * Returns lightweight types without `related` or `providerRef`.
+ */
+export declare function transformEntitySummary(raw: RawSearchEntityBase & Record<string, unknown>, lang: string): SearchEntitySummary;
+//# sourceMappingURL=transformer.d.ts.map

package/api/fansunited/search/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/fansunited/search/transformer.ts"],"names":[],"mappings":"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"}

package/api/fansunited/search/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Types for the Fans United Search API
+ */
+import type { NextCacheOptions } from "../http";
+import type { DataLayerConfig } from "../../../config";
+import type { FUSportsCompetition, FUSportsTeamCompetitor, FUSportsPlayerCompetitor, FUSportsCountry, FUSportsVenue, FUSportsCoach, FUSportsCompetitionSummary, FUSportsTeamSummary, FUSportsPlayerSummary, FUSportsCountrySummary, FUSportsVenueSummary, FUSportsCoachSummary } from "../../../types/canonical/base.types";
+export type SearchMode = "CASE_INSENSITIVE" | "CASE_SENSITIVE" | "FULL_MATCH";
+export type EntityContentType = "venue" | "athlete" | "team" | "competition" | "country" | "coach";
+export interface PaginationMeta {
+    current_page: number;
+    items_per_page: number;
+    total_items: number;
+    number_of_pages: number;
+}
+/**
+ * Summary union — returned by list/search functions.
+ * No `related` or `providerRef` fields, only lightweight data for rendering lists.
+ */
+export type SearchEntitySummary = (FUSportsCompetitionSummary & {
+    entityType: "competition";
+}) | (FUSportsTeamSummary & {
+    entityType: "team";
+}) | (FUSportsPlayerSummary & {
+    entityType: "athlete";
+}) | (FUSportsCountrySummary & {
+    entityType: "country";
+}) | (FUSportsVenueSummary & {
+    entityType: "venue";
+}) | (FUSportsCoachSummary & {
+    entityType: "coach";
+});
+/**
+ * Full union — returned by getById/getByIds functions.
+ * Includes `related` (hydrated one level deep) and `providerRef`.
+ */
+export type SearchEntityResult = (FUSportsCompetition & {
+    entityType: "competition";
+}) | (FUSportsTeamCompetitor & {
+    entityType: "team";
+}) | (FUSportsPlayerCompetitor & {
+    entityType: "athlete";
+}) | (FUSportsCountry & {
+    entityType: "country";
+}) | (FUSportsVenue & {
+    entityType: "venue";
+}) | (FUSportsCoach & {
+    entityType: "coach";
+});
+/**
+ * Raw entity as stored in cache (before transformation).
+ * Kept loose so we cache exactly what the API returns.
+ */
+export interface RawSearchEntity {
+    id: string;
+    [key: string]: unknown;
+}
+export interface EntitySearchResponse {
+    data: RawSearchEntity[];
+    meta: {
+        pagination: PaginationMeta;
+    };
+}
+export interface PaginatedResult<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+export interface EntitySearchOptions {
+    query?: string;
+    contentType?: EntityContentType;
+    ids?: string[];
+    limit?: number;
+    page?: number;
+    mode?: SearchMode;
+    sport?: string;
+    relationship?: string;
+    value?: string;
+    lang?: string;
+    next?: NextCacheOptions;
+    config?: DataLayerConfig;
+}
+export interface GetEntityByIdOptions {
+    lang?: string;
+    next?: NextCacheOptions;
+    config?: DataLayerConfig;
+}
+export interface GetEntitiesByIdsOptions {
+    lang?: string;
+    next?: NextCacheOptions;
+    config?: DataLayerConfig;
+}
+export interface GetCompetitionsOptions {
+    query?: string;
+    limit?: number;
+    page?: number;
+    sport?: string;
+    lang?: string;
+    next?: NextCacheOptions;
+    config?: DataLayerConfig;
+}
+export interface GetTeamsByCountryOptions {
+    query?: string;
+    limit?: number;
+    page?: number;
+    sport?: string;
+    lang?: string;
+    next?: NextCacheOptions;
+    config?: DataLayerConfig;
+}
+export interface GetTeamsByCompetitionOptions {
+    query?: string;
+    limit?: number;
+    page?: number;
+    sport?: string;
+    lang?: string;
+    next?: NextCacheOptions;
+    config?: DataLayerConfig;
+}
+export interface GetCountriesOptions {
+    query?: string;
+    limit?: number;
+    page?: number;
+    sport?: string;
+    lang?: string;
+    next?: NextCacheOptions;
+    config?: DataLayerConfig;
+}
+export interface GetVenuesOptions {
+    query?: string;
+    limit?: number;
+    page?: number;
+    sport?: string;
+    lang?: string;
+    next?: NextCacheOptions;
+    config?: DataLayerConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/api/fansunited/search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/fansunited/search/types.ts"],"names":[],"mappings":"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"}

package/cache/__tests__/cache-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cache-manager.test.d.ts.map

package/cache/__tests__/cache-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.test.d.ts","sourceRoot":"","sources":["../../../src/lib/cache/__tests__/cache-manager.test.ts"],"names":[],"mappings":""}

package/cache/__tests__/cleanup.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cleanup.test.d.ts.map

package/cache/__tests__/cleanup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.test.d.ts","sourceRoot":"","sources":["../../../src/lib/cache/__tests__/cleanup.test.ts"],"names":[],"mappings":""}

package/cache/__tests__/memory-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-store.test.d.ts.map

package/cache/__tests__/memory-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.test.d.ts","sourceRoot":"","sources":["../../../src/lib/cache/__tests__/memory-store.test.ts"],"names":[],"mappings":""}

package/cache/__tests__/sqlite-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite-store.test.d.ts.map

package/cache/__tests__/sqlite-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.test.d.ts","sourceRoot":"","sources":["../../../src/lib/cache/__tests__/sqlite-store.test.ts"],"names":[],"mappings":""}

package/cache/cache-manager.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Cache Manager - Orchestrates L1 (memory) + optional L2 with SWR pattern
+ *
+ * L2 (SQLite) is never statically imported here — it's injected at runtime
+ * via initL2() so that browser bundles don't pull in better-sqlite3.
+ */
+import type { CacheEntry, EntityCacheConfig, EntityType } from "./types";
+/** Interface that L2 stores must satisfy */
+export interface L2Store {
+    get isInitialized(): boolean;
+    get<T>(key: string): CacheEntry<T> | undefined;
+    set(key: string, entity: string, data: unknown): void;
+    setMany(entries: {
+        key: string;
+        entity: string;
+        data: unknown;
+    }[]): void;
+    cleanup(entity: string, maxTTLSeconds: number): number;
+    clear(): void;
+}
+/**
+ * Initialize L2 cache layer. Call on server startup.
+ * Client-side apps skip this — L2 is never loaded.
+ */
+export declare function initL2(store: L2Store): void;
+/** Get the L2 store (if initialized) */
+export declare function getL2(): L2Store | null;
+declare const ENTITY_TTL_CONFIG: Record<EntityType, EntityCacheConfig>;
+/**
+ * Single-key cache-through with SWR (Stale-While-Revalidate)
+ */
+export declare function cached<T>(key: string, entity: EntityType, fetcher: () => Promise<T>): Promise<T>;
+/**
+ * Smart batch cache — only fetches uncached IDs from the API
+ */
+export declare function cachedBatch<T>(ids: string[], entity: EntityType, batchFetcher: (missingIds: string[]) => Promise<Map<string, T>>, keyFn: (id: string) => string): Promise<Map<string, T>>;
+/**
+ * Remove an entry from both cache layers
+ */
+export declare function invalidate(key: string): void;
+export { ENTITY_TTL_CONFIG };
+//# sourceMappingURL=cache-manager.d.ts.map

package/cache/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/lib/cache/cache-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEzE,4CAA4C;AAC5C,MAAM,WAAW,OAAO;IACpB,IAAI,aAAa,IAAI,OAAO,CAAC;IAC7B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACtD,OAAO,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,GAAG,IAAI,CAAC;IACzE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IACvD,KAAK,IAAI,IAAI,CAAC;CACjB;AAKD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE3C;AAED,wCAAwC;AACxC,wBAAgB,KAAK,IAAI,OAAO,GAAG,IAAI,CAEtC;AAED,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAQ5D,CAAC;AAwCF;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoCtG;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EAAE,EACb,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAC/D,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAC9B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CA6DzB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE5C;AAGD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/cache/cleanup.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Periodic L2 cache cleanup
+ */
+export declare function runCleanup(): void;
+export declare function startCleanupSchedule(intervalMs?: number): void;
+export declare function stopCleanupSchedule(): void;
+//# sourceMappingURL=cleanup.d.ts.map

package/cache/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/lib/cache/cleanup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,wBAAgB,UAAU,IAAI,IAAI,CAWjC;AAED,wBAAgB,oBAAoB,CAAC,UAAU,SAAiB,GAAG,IAAI,CAGtE;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C"}

package/cache/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cache layer - public API
+ *
+ * NOTE: sqlite-store.ts is NOT exported here to avoid pulling better-sqlite3
+ * into browser bundles. Server-side consumers should import it directly:
+ *   import { initSqliteStore, sqliteStore } from './cache/sqlite-store';
+ */
+export { memoryStore } from "./memory-store";
+export { cached, cachedBatch, invalidate, initL2 } from "./cache-manager";
+export type { L2Store } from "./cache-manager";
+export { runCleanup, startCleanupSchedule, stopCleanupSchedule } from "./cleanup";
+export type { CacheEntry, EntityCacheConfig, EntityType } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC1E,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/cache/memory-store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * L1 Cache - LRU in-memory store
+ */
+import type { CacheEntry } from "./types";
+export declare const memoryStore: {
+    get<T>(key: string): CacheEntry<T> | undefined;
+    set<T>(key: string, data: T): void;
+    delete(key: string): void;
+    clear(): void;
+    readonly size: number;
+};
+//# sourceMappingURL=memory-store.d.ts.map

package/cache/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/lib/cache/memory-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAW1C,eAAO,MAAM,WAAW;QAChB,CAAC,OAAO,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS;QAI1C,CAAC,OAAO,MAAM,QAAQ,CAAC,GAAG,IAAI;gBAItB,MAAM,GAAG,IAAI;aAIhB,IAAI;mBAID,MAAM;CAGrB,CAAC"}

package/cache/sqlite-store.d.ts

@@ -0,0 +1,19 @@
+/**
+ * L2 Cache - SQLite on-disk store (server-only)
+ */
+import type { CacheEntry } from "./types";
+export declare function initSqliteStore(dbPath?: string): void;
+export declare const sqliteStore: {
+    readonly isInitialized: boolean;
+    get<T>(key: string): CacheEntry<T> | undefined;
+    set(key: string, entity: string, data: unknown): void;
+    setMany(entries: {
+        key: string;
+        entity: string;
+        data: unknown;
+    }[]): void;
+    cleanup(entity: string, maxTTLSeconds: number): number;
+    clear(): void;
+    close(): void;
+};
+//# sourceMappingURL=sqlite-store.d.ts.map

package/cache/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../src/lib/cache/sqlite-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAW1C,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CA4BrD;AAED,eAAO,MAAM,WAAW;4BACC,OAAO;QAIxB,CAAC,OAAO,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS;aAarC,MAAM,UAAU,MAAM,QAAQ,OAAO,GAAG,IAAI;qBASpC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,GAAG,IAAI;oBAgBxD,MAAM,iBAAiB,MAAM,GAAG,MAAM;aAQ7C,IAAI;aAIJ,IAAI;CAMhB,CAAC"}

package/cache/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared cache types
+ */
+export interface CacheEntry<T> {
+    data: T;
+    storedAt: number;
+}
+export interface EntityCacheConfig {
+    /** Time in seconds before data is considered stale (triggers background refresh) */
+    staleTTL: number;
+    /** Time in seconds before data is completely expired and must be re-fetched */
+    maxTTL: number;
+}
+export type EntityType = "competitions" | "teams" | "athletes" | "venues" | "countries" | "coaches" | "search";
+//# sourceMappingURL=types.d.ts.map

package/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/cache/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC"}

package/client.js

@@ -1,7 +1,7 @@
 "use client";
 import Ds, { createContext as Xe, useContext as Je, useMemo as P, useCallback as v, useState as U, useEffect as ue, useRef as Ls } from "react";
-import { v as xs, y as Ns, m as Gs, x as ga, z as fa, A as ya, o as wa, q as $s, u as Us, p as Bs, B as Hs, D as Vs, l as Ws } from "./matches-CIte0UPI.js";
-import { C as fh } from "./matches-CIte0UPI.js";
+import { w as xs, z as Ns, n as Gs, y as ga, A as fa, B as ya, p as wa, r as $s, v as Us, q as Bs, C as Hs, E as Vs, m as Ws } from "./matches-dKvggZia.js";
+import { D as fh } from "./matches-dKvggZia.js";
 var nt = { exports: {} }, Be = {};
 var _a;
 function zs() {

package/config/types.d.ts

@@ -31,6 +31,8 @@ export interface DataLayerConfig {
         apiKey: string;
         /** Client ID for FansUnited services (required) */
         clientId: string;
+        /** Default language for search results (e.g., "EN", "BG"). Defaults to "EN" */
+        lang?: string;
     };
 }
 //# sourceMappingURL=types.d.ts.map

package/config/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC5B,kDAAkD;IAClD,qBAAqB,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;IAElE,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAE1C,gCAAgC;IAChC,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;;OAIG;IACH,UAAU,CAAC,EAAE;QACT,iDAAiD;QACjD,MAAM,EAAE,MAAM,CAAC;QACf,mDAAmD;QACnD,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;CACL"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC5B,kDAAkD;IAClD,qBAAqB,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;IAElE,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAE1C,gCAAgC;IAChC,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;;OAIG;IACH,UAAU,CAAC,EAAE;QACT,iDAAiD;QACjD,MAAM,EAAE,MAAM,CAAC;QACf,mDAAmD;QACnD,QAAQ,EAAE,MAAM,CAAC;QACjB,+EAA+E;QAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACL"}