fansunited-data-layer 0.16.0 → 0.17.2

package/api/fansunited/sports/competition/__tests__/exports.test.d.ts.map

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

package/api/fansunited/sports/competition/__tests__/hydrated.test.d.ts

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

package/api/fansunited/sports/competition/__tests__/hydrated.test.d.ts.map

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

package/api/fansunited/sports/competition/__tests__/index.test.d.ts

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

package/api/fansunited/sports/competition/__tests__/index.test.d.ts.map

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

package/api/fansunited/sports/competition/hydrated.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Hydrated wrapper for the Fans United Sports API competition endpoint.
+ *
+ * Composes the (cached) raw competition response with a (cached) batch
+ * resolution of every entity ID in `meta.entityIds` via the Search API,
+ * and returns one object the consumer can render directly.
+ *
+ * Cache topology:
+ *   - sports/competition response → cached under "sportsCompetition"
+ *     (5min stale / 1h max) by id+season.
+ *   - search/entity responses     → cached under "search" (24h stale / 7d max)
+ *     by id only; the raw multi-locale payload serves every locale via
+ *     transformEntity(raw, lang).
+ *
+ * @example
+ * const data = await getFansUnitedSportsCompetitionHydrated("fb:c:1", { locale: "BG" });
+ * for (const entry of data.season.stages[0].groups[0].standings) {
+ *   const team = data.entities.get(entry.competitorId);
+ *   console.log(`${entry.rank} ${team?.name}`);
+ * }
+ */
+import type { FUSportsCompetitionDetails } from "../../../../types/canonical/sports-competition.types";
+import type { DataLayerConfig } from "../../../../config";
+import type { NextCacheOptions } from "../../http";
+import type { SearchEntityResult } from "../../search/types";
+export interface GetSportsCompetitionHydratedOptions {
+    /** Season identifier (e.g. "fb:c:1:2025/26"). Defaults to the active season. */
+    seasonId?: string;
+    /** Locale code (e.g. "EN", "BG") used to resolve entity translations. Falls back to EN. */
+    locale?: string;
+    /** Next.js cache options for ISR/on-demand revalidation. */
+    next?: NextCacheOptions;
+}
+/**
+ * Sports API competition response plus a lookup map for every referenced entity.
+ *
+ * The map is keyed by entity ID. Missing IDs (404s from the Search API) are
+ * silently omitted — render code should fall back gracefully on a missing entry:
+ *   `entities.get(id) ?? { name: id }`.
+ */
+export interface FUSportsCompetitionHydrated extends FUSportsCompetitionDetails {
+    entities: Map<string, SearchEntityResult>;
+}
+export declare function getFansUnitedSportsCompetitionHydrated(competitionId: string, options?: GetSportsCompetitionHydratedOptions, config?: DataLayerConfig): Promise<FUSportsCompetitionHydrated>;
+//# sourceMappingURL=hydrated.d.ts.map

package/api/fansunited/sports/competition/hydrated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrated.d.ts","sourceRoot":"","sources":["../../../../../src/lib/api/fansunited/sports/competition/hydrated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AACvG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAI7D,MAAM,WAAW,mCAAmC;IAChD,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA4B,SAAQ,0BAA0B;IAC3E,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC7C;AAED,wBAAsB,sCAAsC,CACxD,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,mCAAmC,EAC7C,MAAM,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,2BAA2B,CAAC,CAsBtC"}

package/api/fansunited/sports/competition/hydrated.js

@@ -0,0 +1,26 @@
+import { getFansUnitedSportsCompetition } from "./index.js";
+import { getFansUnitedEntitiesByIds } from "../../search/index.js";
+async function getFansUnitedSportsCompetitionHydrated(competitionId, options, config) {
+  const raw = await getFansUnitedSportsCompetition(
+    competitionId,
+    { seasonId: options?.seasonId, next: options?.next },
+    config
+  );
+  const entityIds = raw.meta.entityIds;
+  const entities = /* @__PURE__ */ new Map();
+  if (entityIds.length > 0) {
+    const resolved = await getFansUnitedEntitiesByIds(entityIds, {
+      lang: options?.locale,
+      next: options?.next,
+      config
+    });
+    for (const e of resolved) {
+      entities.set(e.id, e);
+    }
+  }
+  return { ...raw, entities };
+}
+export {
+  getFansUnitedSportsCompetitionHydrated
+};
+//# sourceMappingURL=hydrated.js.map

package/api/fansunited/sports/competition/hydrated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrated.js","sources":["../../../../../src/lib/api/fansunited/sports/competition/hydrated.ts"],"sourcesContent":["/**\n * Hydrated wrapper for the Fans United Sports API competition endpoint.\n *\n * Composes the (cached) raw competition response with a (cached) batch\n * resolution of every entity ID in `meta.entityIds` via the Search API,\n * and returns one object the consumer can render directly.\n *\n * Cache topology:\n *   - sports/competition response → cached under \"sportsCompetition\"\n *     (5min stale / 1h max) by id+season.\n *   - search/entity responses     → cached under \"search\" (24h stale / 7d max)\n *     by id only; the raw multi-locale payload serves every locale via\n *     transformEntity(raw, lang).\n *\n * @example\n * const data = await getFansUnitedSportsCompetitionHydrated(\"fb:c:1\", { locale: \"BG\" });\n * for (const entry of data.season.stages[0].groups[0].standings) {\n *   const team = data.entities.get(entry.competitorId);\n *   console.log(`${entry.rank} ${team?.name}`);\n * }\n */\n\nimport type { FUSportsCompetitionDetails } from \"../../../../types/canonical/sports-competition.types\";\nimport type { DataLayerConfig } from \"../../../../config\";\nimport type { NextCacheOptions } from \"../../http\";\nimport type { SearchEntityResult } from \"../../search/types\";\nimport { getFansUnitedSportsCompetition } from \"./index\";\nimport { getFansUnitedEntitiesByIds } from \"../../search\";\n\nexport interface GetSportsCompetitionHydratedOptions {\n    /** Season identifier (e.g. \"fb:c:1:2025/26\"). Defaults to the active season. */\n    seasonId?: string;\n    /** Locale code (e.g. \"EN\", \"BG\") used to resolve entity translations. Falls back to EN. */\n    locale?: string;\n    /** Next.js cache options for ISR/on-demand revalidation. */\n    next?: NextCacheOptions;\n}\n\n/**\n * Sports API competition response plus a lookup map for every referenced entity.\n *\n * The map is keyed by entity ID. Missing IDs (404s from the Search API) are\n * silently omitted — render code should fall back gracefully on a missing entry:\n *   `entities.get(id) ?? { name: id }`.\n */\nexport interface FUSportsCompetitionHydrated extends FUSportsCompetitionDetails {\n    entities: Map<string, SearchEntityResult>;\n}\n\nexport async function getFansUnitedSportsCompetitionHydrated(\n    competitionId: string,\n    options?: GetSportsCompetitionHydratedOptions,\n    config?: DataLayerConfig\n): Promise<FUSportsCompetitionHydrated> {\n    const raw = await getFansUnitedSportsCompetition(\n        competitionId,\n        { seasonId: options?.seasonId, next: options?.next },\n        config\n    );\n\n    const entityIds = raw.meta.entityIds;\n    const entities = new Map<string, SearchEntityResult>();\n\n    if (entityIds.length > 0) {\n        const resolved = await getFansUnitedEntitiesByIds(entityIds, {\n            lang: options?.locale,\n            next: options?.next,\n            config,\n        });\n        for (const e of resolved) {\n            entities.set(e.id, e);\n        }\n    }\n\n    return { ...raw, entities };\n}\n"],"names":[],"mappings":";;AAiDA,eAAsB,uCAClB,eACA,SACA,QACoC;AACpC,QAAM,MAAM,MAAM;AAAA,IACd;AAAA,IACA,EAAE,UAAU,SAAS,UAAU,MAAM,SAAS,KAAA;AAAA,IAC9C;AAAA,EAAA;AAGJ,QAAM,YAAY,IAAI,KAAK;AAC3B,QAAM,+BAAe,IAAA;AAErB,MAAI,UAAU,SAAS,GAAG;AACtB,UAAM,WAAW,MAAM,2BAA2B,WAAW;AAAA,MACzD,MAAM,SAAS;AAAA,MACf,MAAM,SAAS;AAAA,MACf;AAAA,IAAA,CACH;AACD,eAAW,KAAK,UAAU;AACtB,eAAS,IAAI,EAAE,IAAI,CAAC;AAAA,IACxB;AAAA,EACJ;AAEA,SAAO,EAAE,GAAG,KAAK,SAAA;AACrB;"}

package/api/fansunited/sports/competition/index.d.ts

@@ -8,21 +8,12 @@ export type { GetSportsCompetitionOptions } from "./types";
 /**
  * Get a competition by ID from the Fans United Sports API.
  *
+ * Cached with SWR under entity type "sportsCompetition" (5min stale / 1h max).
+ * Cache key: `fudl:sports:competition:<id>:<seasonId | "active">`.
+ *
  * @param competitionId - Competition identifier (e.g. "fb:c:1")
  * @param options - Query options (season override, Next.js cache hints)
  * @param config - Optional data layer config (uses the singleton if omitted)
- *
- * @example
- * ```typescript
- * const competition = await getFansUnitedSportsCompetition("fb:c:1");
- * for (const stage of competition.season.stages) {
- *   if (stage.type === "standing") {
- *     for (const group of stage.groups ?? []) {
- *       console.log(group.standings.map(s => `${s.rank} ${s.competitorId}`));
- *     }
- *   }
- * }
- * ```
  */
 export declare function getFansUnitedSportsCompetition(competitionId: string, options?: GetSportsCompetitionOptions, config?: DataLayerConfig): Promise<FUSportsCompetitionDetails>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/api/fansunited/sports/competition/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AACvG,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrE,OAAO,KAAK,EAAE,2BAA2B,EAAgC,MAAM,SAAS,CAAC;AAEzF,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,8BAA8B,CAChD,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,2BAA2B,EACrC,MAAM,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,0BAA0B,CAAC,CAgBrC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/api/fansunited/sports/competition/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AACvG,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIrE,OAAO,KAAK,EAAE,2BAA2B,EAAgC,MAAM,SAAS,CAAC;AAEzF,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;GASG;AACH,wBAAsB,8BAA8B,CAChD,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,2BAA2B,EACrC,MAAM,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,0BAA0B,CAAC,CAoBrC"}

package/api/fansunited/sports/competition/index.js

@@ -1,19 +1,25 @@
 import { getConfig } from "../../../../config/index.js";
 import { sportsHttp } from "../http.js";
 import { transformSportsCompetition } from "./transformer.js";
+import { cached } from "../../../../cache/cache-manager.js";
+import { CACHE_KEY_PREFIX } from "../../../../cache/types.js";
 async function getFansUnitedSportsCompetition(competitionId, options, config) {
   const finalConfig = config || getConfig();
-  const params = {};
-  if (options?.seasonId) {
-    params.season_id = options.seasonId;
-  }
-  const raw = await sportsHttp.get({
-    path: `/v1/competitions/${competitionId}`,
-    params,
-    next: options?.next,
-    config: finalConfig
+  const seasonKeyPart = options?.seasonId ?? "active";
+  const cacheKey = `${CACHE_KEY_PREFIX}sports:competition:${competitionId}:${seasonKeyPart}`;
+  return cached(cacheKey, "sportsCompetition", async () => {
+    const params = {};
+    if (options?.seasonId) {
+      params.season_id = options.seasonId;
+    }
+    const raw = await sportsHttp.get({
+      path: `/v1/competitions/${competitionId}`,
+      params,
+      next: options?.next,
+      config: finalConfig
+    });
+    return transformSportsCompetition(raw);
   });
-  return transformSportsCompetition(raw);
 }
 export {
   getFansUnitedSportsCompetition

package/api/fansunited/sports/competition/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../../src/lib/api/fansunited/sports/competition/index.ts"],"sourcesContent":["/**\n * Competition endpoint for the Fans United Sports API.\n */\n\nimport type { FUSportsCompetitionDetails } from \"../../../../types/canonical/sports-competition.types\";\nimport { getConfig, type DataLayerConfig } from \"../../../../config\";\nimport { sportsHttp } from \"../http\";\nimport { transformSportsCompetition } from \"./transformer\";\nimport type { GetSportsCompetitionOptions, RawSportsCompetitionResponse } from \"./types\";\n\nexport type { GetSportsCompetitionOptions } from \"./types\";\n\n/**\n * Get a competition by ID from the Fans United Sports API.\n *\n * @param competitionId - Competition identifier (e.g. \"fb:c:1\")\n * @param options - Query options (season override, Next.js cache hints)\n * @param config - Optional data layer config (uses the singleton if omitted)\n *\n * @example\n * ```typescript\n * const competition = await getFansUnitedSportsCompetition(\"fb:c:1\");\n * for (const stage of competition.season.stages) {\n *   if (stage.type === \"standing\") {\n *     for (const group of stage.groups ?? []) {\n *       console.log(group.standings.map(s => `${s.rank} ${s.competitorId}`));\n *     }\n *   }\n * }\n * ```\n */\nexport async function getFansUnitedSportsCompetition(\n    competitionId: string,\n    options?: GetSportsCompetitionOptions,\n    config?: DataLayerConfig\n): Promise<FUSportsCompetitionDetails> {\n    const finalConfig = config || getConfig();\n\n    const params: Record<string, string | undefined> = {};\n    if (options?.seasonId) {\n        params.season_id = options.seasonId;\n    }\n\n    const raw = await sportsHttp.get<RawSportsCompetitionResponse>({\n        path: `/v1/competitions/${competitionId}`,\n        params,\n        next: options?.next,\n        config: finalConfig,\n    });\n\n    return transformSportsCompetition(raw);\n}\n"],"names":[],"mappings":";;;AA+BA,eAAsB,+BAClB,eACA,SACA,QACmC;AACnC,QAAM,cAAc,UAAU,UAAA;AAE9B,QAAM,SAA6C,CAAA;AACnD,MAAI,SAAS,UAAU;AACnB,WAAO,YAAY,QAAQ;AAAA,EAC/B;AAEA,QAAM,MAAM,MAAM,WAAW,IAAkC;AAAA,IAC3D,MAAM,oBAAoB,aAAa;AAAA,IACvC;AAAA,IACA,MAAM,SAAS;AAAA,IACf,QAAQ;AAAA,EAAA,CACX;AAED,SAAO,2BAA2B,GAAG;AACzC;"}
+{"version":3,"file":"index.js","sources":["../../../../../src/lib/api/fansunited/sports/competition/index.ts"],"sourcesContent":["/**\n * Competition endpoint for the Fans United Sports API.\n */\n\nimport type { FUSportsCompetitionDetails } from \"../../../../types/canonical/sports-competition.types\";\nimport { getConfig, type DataLayerConfig } from \"../../../../config\";\nimport { cached, CACHE_KEY_PREFIX } from \"../../../../cache\";\nimport { sportsHttp } from \"../http\";\nimport { transformSportsCompetition } from \"./transformer\";\nimport type { GetSportsCompetitionOptions, RawSportsCompetitionResponse } from \"./types\";\n\nexport type { GetSportsCompetitionOptions } from \"./types\";\n\n/**\n * Get a competition by ID from the Fans United Sports API.\n *\n * Cached with SWR under entity type \"sportsCompetition\" (5min stale / 1h max).\n * Cache key: `fudl:sports:competition:<id>:<seasonId | \"active\">`.\n *\n * @param competitionId - Competition identifier (e.g. \"fb:c:1\")\n * @param options - Query options (season override, Next.js cache hints)\n * @param config - Optional data layer config (uses the singleton if omitted)\n */\nexport async function getFansUnitedSportsCompetition(\n    competitionId: string,\n    options?: GetSportsCompetitionOptions,\n    config?: DataLayerConfig\n): Promise<FUSportsCompetitionDetails> {\n    const finalConfig = config || getConfig();\n    const seasonKeyPart = options?.seasonId ?? \"active\";\n    const cacheKey = `${CACHE_KEY_PREFIX}sports:competition:${competitionId}:${seasonKeyPart}`;\n\n    return cached(cacheKey, \"sportsCompetition\", async () => {\n        const params: Record<string, string | undefined> = {};\n        if (options?.seasonId) {\n            params.season_id = options.seasonId;\n        }\n\n        const raw = await sportsHttp.get<RawSportsCompetitionResponse>({\n            path: `/v1/competitions/${competitionId}`,\n            params,\n            next: options?.next,\n            config: finalConfig,\n        });\n\n        return transformSportsCompetition(raw);\n    });\n}\n"],"names":[],"mappings":";;;;;AAuBA,eAAsB,+BAClB,eACA,SACA,QACmC;AACnC,QAAM,cAAc,UAAU,UAAA;AAC9B,QAAM,gBAAgB,SAAS,YAAY;AAC3C,QAAM,WAAW,GAAG,gBAAgB,sBAAsB,aAAa,IAAI,aAAa;AAExF,SAAO,OAAO,UAAU,qBAAqB,YAAY;AACrD,UAAM,SAA6C,CAAA;AACnD,QAAI,SAAS,UAAU;AACnB,aAAO,YAAY,QAAQ;AAAA,IAC/B;AAEA,UAAM,MAAM,MAAM,WAAW,IAAkC;AAAA,MAC3D,MAAM,oBAAoB,aAAa;AAAA,MACvC;AAAA,MACA,MAAM,SAAS;AAAA,MACf,QAAQ;AAAA,IAAA,CACX;AAED,WAAO,2BAA2B,GAAG;AAAA,EACzC,CAAC;AACL;"}

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

@@ -6,4 +6,10 @@
  */
 export { getFansUnitedSportsCompetition } from "./competition";
 export type { GetSportsCompetitionOptions } from "./competition/types";
+export { getFansUnitedSportsLivescore } from "./livescore";
+export type { GetSportsLivescoreOptions } from "./livescore/types";
+export { getFansUnitedSportsCompetitionHydrated } from "./competition/hydrated";
+export type { FUSportsCompetitionHydrated, GetSportsCompetitionHydratedOptions } from "./competition/hydrated";
+export { getFansUnitedSportsLivescoreHydrated } from "./livescore/hydrated";
+export type { FUSportsLivescoreHydrated, GetSportsLivescoreHydratedOptions } from "./livescore/hydrated";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/fansunited/sports/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/fansunited/sports/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,sCAAsC,EAAE,MAAM,wBAAwB,CAAC;AAChF,YAAY,EAAE,2BAA2B,EAAE,mCAAmC,EAAE,MAAM,wBAAwB,CAAC;AAE/G,OAAO,EAAE,oCAAoC,EAAE,MAAM,sBAAsB,CAAC;AAC5E,YAAY,EAAE,yBAAyB,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC"}

package/api/fansunited/sports/livescore/__tests__/hydrated.test.d.ts

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

package/api/fansunited/sports/livescore/__tests__/hydrated.test.d.ts.map

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

package/api/fansunited/sports/livescore/hydrated.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Hydrated wrapper for the Fans United Sports API livescore endpoint.
+ *
+ * Returns the raw livescore payload merged with a lookup map of every
+ * referenced entity (competitions + competitors), resolved through the
+ * Search API.
+ *
+ * Cache topology — different from {@link getFansUnitedSportsCompetitionHydrated}:
+ *   - livescore response → **not** cached. Live scores change minute-by-minute,
+ *     and the design spec keeps live data on a client-side polling channel
+ *     rather than the SWR cache. Each call hits the livescore API fresh.
+ *   - search/entity responses → cached under "search" (24h stale / 7d max)
+ *     by id only; the raw multi-locale payload serves every locale via
+ *     transformEntity(raw, lang).
+ *
+ * The net effect: repeated calls to this function each make one livescore
+ * request, but reuse already-fetched entity payloads across calls and locales.
+ *
+ * @example
+ * const board = await getFansUnitedSportsLivescoreHydrated({ sport: "FOOTBALL", locale: "BG" });
+ * for (const group of board.data) {
+ *   const comp = board.entities.get(group.competitionId);
+ *   console.log(`${comp?.name} — ${group.events.length} events`);
+ *   for (const event of group.events) {
+ *     const home = board.entities.get(event.competitorOne.id);
+ *     const away = board.entities.get(event.competitorTwo.id);
+ *     console.log(`  ${home?.name} vs ${away?.name}`);
+ *   }
+ * }
+ */
+import type { FUSportsLivescore } from "../../../../types/canonical/sports-livescore.types";
+import type { DataLayerConfig } from "../../../../config";
+import type { SearchEntityResult } from "../../search/types";
+import type { GetSportsLivescoreOptions } from "./types";
+export interface GetSportsLivescoreHydratedOptions extends GetSportsLivescoreOptions {
+    /** Locale code (e.g. "EN", "BG") used to resolve entity translations. Falls back to EN. */
+    locale?: string;
+}
+/**
+ * Livescore payload plus a lookup map for every referenced entity
+ * (competitions + competitors). Missing IDs are silently omitted — render
+ * code should fall back gracefully: `entities.get(id) ?? { name: id }`.
+ */
+export interface FUSportsLivescoreHydrated extends FUSportsLivescore {
+    entities: Map<string, SearchEntityResult>;
+}
+export declare function getFansUnitedSportsLivescoreHydrated(options?: GetSportsLivescoreHydratedOptions, config?: DataLayerConfig): Promise<FUSportsLivescoreHydrated>;
+//# sourceMappingURL=hydrated.d.ts.map

package/api/fansunited/sports/livescore/hydrated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrated.d.ts","sourceRoot":"","sources":["../../../../../src/lib/api/fansunited/sports/livescore/hydrated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAChF,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAChE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC7C;AAiBD,wBAAsB,oCAAoC,CACtD,OAAO,CAAC,EAAE,iCAAiC,EAC3C,MAAM,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,yBAAyB,CAAC,CAmBpC"}

package/api/fansunited/sports/livescore/hydrated.js

@@ -0,0 +1,34 @@
+import { getFansUnitedSportsLivescore } from "./index.js";
+import { getFansUnitedEntitiesByIds } from "../../search/index.js";
+function collectEntityIds(livescore) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const group of livescore.data) {
+    if (group.competitionId) ids.add(group.competitionId);
+    for (const event of group.events) {
+      if (event.competitorOne?.id) ids.add(event.competitorOne.id);
+      if (event.competitorTwo?.id) ids.add(event.competitorTwo.id);
+    }
+  }
+  return Array.from(ids);
+}
+async function getFansUnitedSportsLivescoreHydrated(options, config) {
+  const { locale, ...livescoreOptions } = options ?? {};
+  const raw = await getFansUnitedSportsLivescore(livescoreOptions, config);
+  const entityIds = collectEntityIds(raw);
+  const entities = /* @__PURE__ */ new Map();
+  if (entityIds.length > 0) {
+    const resolved = await getFansUnitedEntitiesByIds(entityIds, {
+      lang: locale,
+      next: livescoreOptions.next,
+      config
+    });
+    for (const e of resolved) {
+      entities.set(e.id, e);
+    }
+  }
+  return { ...raw, entities };
+}
+export {
+  getFansUnitedSportsLivescoreHydrated
+};
+//# sourceMappingURL=hydrated.js.map

package/api/fansunited/sports/livescore/hydrated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrated.js","sources":["../../../../../src/lib/api/fansunited/sports/livescore/hydrated.ts"],"sourcesContent":["/**\n * Hydrated wrapper for the Fans United Sports API livescore endpoint.\n *\n * Returns the raw livescore payload merged with a lookup map of every\n * referenced entity (competitions + competitors), resolved through the\n * Search API.\n *\n * Cache topology — different from {@link getFansUnitedSportsCompetitionHydrated}:\n *   - livescore response → **not** cached. Live scores change minute-by-minute,\n *     and the design spec keeps live data on a client-side polling channel\n *     rather than the SWR cache. Each call hits the livescore API fresh.\n *   - search/entity responses → cached under \"search\" (24h stale / 7d max)\n *     by id only; the raw multi-locale payload serves every locale via\n *     transformEntity(raw, lang).\n *\n * The net effect: repeated calls to this function each make one livescore\n * request, but reuse already-fetched entity payloads across calls and locales.\n *\n * @example\n * const board = await getFansUnitedSportsLivescoreHydrated({ sport: \"FOOTBALL\", locale: \"BG\" });\n * for (const group of board.data) {\n *   const comp = board.entities.get(group.competitionId);\n *   console.log(`${comp?.name} — ${group.events.length} events`);\n *   for (const event of group.events) {\n *     const home = board.entities.get(event.competitorOne.id);\n *     const away = board.entities.get(event.competitorTwo.id);\n *     console.log(`  ${home?.name} vs ${away?.name}`);\n *   }\n * }\n */\n\nimport type { FUSportsLivescore } from \"../../../../types/canonical/sports-livescore.types\";\nimport type { DataLayerConfig } from \"../../../../config\";\nimport type { SearchEntityResult } from \"../../search/types\";\nimport { getFansUnitedSportsLivescore } from \"./index\";\nimport { getFansUnitedEntitiesByIds } from \"../../search\";\nimport type { GetSportsLivescoreOptions } from \"./types\";\n\nexport interface GetSportsLivescoreHydratedOptions extends GetSportsLivescoreOptions {\n    /** Locale code (e.g. \"EN\", \"BG\") used to resolve entity translations. Falls back to EN. */\n    locale?: string;\n}\n\n/**\n * Livescore payload plus a lookup map for every referenced entity\n * (competitions + competitors). Missing IDs are silently omitted — render\n * code should fall back gracefully: `entities.get(id) ?? { name: id }`.\n */\nexport interface FUSportsLivescoreHydrated extends FUSportsLivescore {\n    entities: Map<string, SearchEntityResult>;\n}\n\n/**\n * Collect every entity ID referenced in the livescore response, deduplicated.\n */\nfunction collectEntityIds(livescore: FUSportsLivescore): string[] {\n    const ids = new Set<string>();\n    for (const group of livescore.data) {\n        if (group.competitionId) ids.add(group.competitionId);\n        for (const event of group.events) {\n            if (event.competitorOne?.id) ids.add(event.competitorOne.id);\n            if (event.competitorTwo?.id) ids.add(event.competitorTwo.id);\n        }\n    }\n    return Array.from(ids);\n}\n\nexport async function getFansUnitedSportsLivescoreHydrated(\n    options?: GetSportsLivescoreHydratedOptions,\n    config?: DataLayerConfig\n): Promise<FUSportsLivescoreHydrated> {\n    const { locale, ...livescoreOptions } = options ?? {};\n    const raw = await getFansUnitedSportsLivescore(livescoreOptions, config);\n\n    const entityIds = collectEntityIds(raw);\n    const entities = new Map<string, SearchEntityResult>();\n\n    if (entityIds.length > 0) {\n        const resolved = await getFansUnitedEntitiesByIds(entityIds, {\n            lang: locale,\n            next: livescoreOptions.next,\n            config,\n        });\n        for (const e of resolved) {\n            entities.set(e.id, e);\n        }\n    }\n\n    return { ...raw, entities };\n}\n"],"names":[],"mappings":";;AAuDA,SAAS,iBAAiB,WAAwC;AAC9D,QAAM,0BAAU,IAAA;AAChB,aAAW,SAAS,UAAU,MAAM;AAChC,QAAI,MAAM,cAAe,KAAI,IAAI,MAAM,aAAa;AACpD,eAAW,SAAS,MAAM,QAAQ;AAC9B,UAAI,MAAM,eAAe,QAAQ,IAAI,MAAM,cAAc,EAAE;AAC3D,UAAI,MAAM,eAAe,QAAQ,IAAI,MAAM,cAAc,EAAE;AAAA,IAC/D;AAAA,EACJ;AACA,SAAO,MAAM,KAAK,GAAG;AACzB;AAEA,eAAsB,qCAClB,SACA,QACkC;AAClC,QAAM,EAAE,QAAQ,GAAG,iBAAA,IAAqB,WAAW,CAAA;AACnD,QAAM,MAAM,MAAM,6BAA6B,kBAAkB,MAAM;AAEvE,QAAM,YAAY,iBAAiB,GAAG;AACtC,QAAM,+BAAe,IAAA;AAErB,MAAI,UAAU,SAAS,GAAG;AACtB,UAAM,WAAW,MAAM,2BAA2B,WAAW;AAAA,MACzD,MAAM;AAAA,MACN,MAAM,iBAAiB;AAAA,MACvB;AAAA,IAAA,CACH;AACD,eAAW,KAAK,UAAU;AACtB,eAAS,IAAI,EAAE,IAAI,CAAC;AAAA,IACxB;AAAA,EACJ;AAEA,SAAO,EAAE,GAAG,KAAK,SAAA;AACrB;"}

package/api/fansunited/sports/livescore/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Livescore endpoint for the Fans United Sports API.
+ */
+import type { FUSportsLivescore } from "../../../../types/canonical/sports-livescore.types";
+import { type DataLayerConfig } from "../../../../config";
+import type { GetSportsLivescoreOptions } from "./types";
+export type { GetSportsLivescoreOptions } from "./types";
+/**
+ * Get live scores from the Fans United Sports API.
+ *
+ * Returns events for a given date grouped by competition, optionally filtered
+ * by sport, competitions, match IDs, and event status. Defaults to the current
+ * date (UTC) and all sports.
+ *
+ * @param options - Query filters and ordering (all optional)
+ * @param config - Optional data layer config (uses the singleton if omitted)
+ *
+ * @example
+ * ```typescript
+ * const livescore = await getFansUnitedSportsLivescore({ sport: "FOOTBALL" });
+ * for (const group of livescore.data) {
+ *   console.log(group.competitionId, group.events.length);
+ * }
+ * ```
+ */
+export declare function getFansUnitedSportsLivescore(options?: GetSportsLivescoreOptions, config?: DataLayerConfig): Promise<FUSportsLivescore>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/api/fansunited/sports/livescore/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAC5F,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrE,OAAO,KAAK,EAAE,yBAAyB,EAA8B,MAAM,SAAS,CAAC;AAErF,YAAY,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,4BAA4B,CAC9C,OAAO,CAAC,EAAE,yBAAyB,EACnC,MAAM,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,iBAAiB,CAAC,CA+B5B"}

package/api/fansunited/sports/livescore/index.js

@@ -0,0 +1,36 @@
+import { getConfig } from "../../../../config/index.js";
+import { sportsHttp } from "../http.js";
+import { transformSportsLivescore } from "./transformer.js";
+async function getFansUnitedSportsLivescore(options, config) {
+  const finalConfig = config || getConfig();
+  const params = {};
+  if (options?.competitionIds?.length) {
+    params.competitions_ids = options.competitionIds.join(",");
+  }
+  if (options?.matchIds?.length) {
+    params.match_ids = options.matchIds.join(",");
+  }
+  if (options?.competitionsOrder?.length) {
+    params.competitions_order = options.competitionsOrder.join(",");
+  }
+  if (options?.date) {
+    params.date = options.date;
+  }
+  if (options?.eventStatus) {
+    params.event_status = options.eventStatus;
+  }
+  if (options?.sport) {
+    params.sport = options.sport;
+  }
+  const raw = await sportsHttp.get({
+    path: "/v1/livescore",
+    params,
+    next: options?.next,
+    config: finalConfig
+  });
+  return transformSportsLivescore(raw);
+}
+export {
+  getFansUnitedSportsLivescore
+};
+//# sourceMappingURL=index.js.map

package/api/fansunited/sports/livescore/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../src/lib/api/fansunited/sports/livescore/index.ts"],"sourcesContent":["/**\n * Livescore endpoint for the Fans United Sports API.\n */\n\nimport type { FUSportsLivescore } from \"../../../../types/canonical/sports-livescore.types\";\nimport { getConfig, type DataLayerConfig } from \"../../../../config\";\nimport { sportsHttp } from \"../http\";\nimport { transformSportsLivescore } from \"./transformer\";\nimport type { GetSportsLivescoreOptions, RawSportsLivescoreResponse } from \"./types\";\n\nexport type { GetSportsLivescoreOptions } from \"./types\";\n\n/**\n * Get live scores from the Fans United Sports API.\n *\n * Returns events for a given date grouped by competition, optionally filtered\n * by sport, competitions, match IDs, and event status. Defaults to the current\n * date (UTC) and all sports.\n *\n * @param options - Query filters and ordering (all optional)\n * @param config - Optional data layer config (uses the singleton if omitted)\n *\n * @example\n * ```typescript\n * const livescore = await getFansUnitedSportsLivescore({ sport: \"FOOTBALL\" });\n * for (const group of livescore.data) {\n *   console.log(group.competitionId, group.events.length);\n * }\n * ```\n */\nexport async function getFansUnitedSportsLivescore(\n    options?: GetSportsLivescoreOptions,\n    config?: DataLayerConfig\n): Promise<FUSportsLivescore> {\n    const finalConfig = config || getConfig();\n\n    const params: Record<string, string | undefined> = {};\n    if (options?.competitionIds?.length) {\n        params.competitions_ids = options.competitionIds.join(\",\");\n    }\n    if (options?.matchIds?.length) {\n        params.match_ids = options.matchIds.join(\",\");\n    }\n    if (options?.competitionsOrder?.length) {\n        params.competitions_order = options.competitionsOrder.join(\",\");\n    }\n    if (options?.date) {\n        params.date = options.date;\n    }\n    if (options?.eventStatus) {\n        params.event_status = options.eventStatus;\n    }\n    if (options?.sport) {\n        params.sport = options.sport;\n    }\n\n    const raw = await sportsHttp.get<RawSportsLivescoreResponse>({\n        path: \"/v1/livescore\",\n        params,\n        next: options?.next,\n        config: finalConfig,\n    });\n\n    return transformSportsLivescore(raw);\n}\n"],"names":[],"mappings":";;;AA8BA,eAAsB,6BAClB,SACA,QAC0B;AAC1B,QAAM,cAAc,UAAU,UAAA;AAE9B,QAAM,SAA6C,CAAA;AACnD,MAAI,SAAS,gBAAgB,QAAQ;AACjC,WAAO,mBAAmB,QAAQ,eAAe,KAAK,GAAG;AAAA,EAC7D;AACA,MAAI,SAAS,UAAU,QAAQ;AAC3B,WAAO,YAAY,QAAQ,SAAS,KAAK,GAAG;AAAA,EAChD;AACA,MAAI,SAAS,mBAAmB,QAAQ;AACpC,WAAO,qBAAqB,QAAQ,kBAAkB,KAAK,GAAG;AAAA,EAClE;AACA,MAAI,SAAS,MAAM;AACf,WAAO,OAAO,QAAQ;AAAA,EAC1B;AACA,MAAI,SAAS,aAAa;AACtB,WAAO,eAAe,QAAQ;AAAA,EAClC;AACA,MAAI,SAAS,OAAO;AAChB,WAAO,QAAQ,QAAQ;AAAA,EAC3B;AAEA,QAAM,MAAM,MAAM,WAAW,IAAgC;AAAA,IACzD,MAAM;AAAA,IACN;AAAA,IACA,MAAM,SAAS;AAAA,IACf,QAAQ;AAAA,EAAA,CACX;AAED,SAAO,yBAAyB,GAAG;AACvC;"}

package/api/fansunited/sports/livescore/transformer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Transforms the raw Sports API livescore response into the canonical
+ * {@link FUSportsLivescore} shape.
+ */
+import type { FUSportsLivescore } from "../../../../types/canonical/sports-livescore.types";
+import type { RawSportsLivescoreResponse } from "./types";
+export declare function transformSportsLivescore(raw: RawSportsLivescoreResponse): FUSportsLivescore;
+//# sourceMappingURL=transformer.d.ts.map

package/api/fansunited/sports/livescore/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../../../../../src/lib/api/fansunited/sports/livescore/transformer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACR,iBAAiB,EAKpB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,KAAK,EAGR,0BAA0B,EAG7B,MAAM,SAAS,CAAC;AAqCjB,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,0BAA0B,GAAG,iBAAiB,CAU3F"}

package/api/fansunited/sports/livescore/transformer.js

@@ -0,0 +1,44 @@
+function transformStatus(raw) {
+  return {
+    type: raw.type,
+    code: raw.code,
+    subType: raw.sub_type
+  };
+}
+function transformScore(raw) {
+  return {
+    key: raw.key,
+    competitorOne: raw.competitor_one,
+    competitorTwo: raw.competitor_two
+  };
+}
+function transformEvent(raw) {
+  return {
+    id: raw.id,
+    status: transformStatus(raw.status),
+    score: raw.score ? raw.score.map(transformScore) : void 0,
+    competitorOne: { id: raw.competitor_one.id, type: raw.competitor_one.type },
+    competitorTwo: { id: raw.competitor_two.id, type: raw.competitor_two.type },
+    startTime: raw.start_time
+  };
+}
+function transformGroup(raw) {
+  return {
+    competitionId: raw.competition_id,
+    sport: raw.sport,
+    events: raw.events.map(transformEvent)
+  };
+}
+function transformSportsLivescore(raw) {
+  return {
+    data: raw.data.map(transformGroup),
+    meta: {
+      totalCompetitions: raw.meta?.total_competitions ?? raw.data.length,
+      totalEvents: raw.meta?.total_events ?? raw.data.reduce((sum, group) => sum + group.events.length, 0)
+    }
+  };
+}
+export {
+  transformSportsLivescore
+};
+//# sourceMappingURL=transformer.js.map

package/api/fansunited/sports/livescore/transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.js","sources":["../../../../../src/lib/api/fansunited/sports/livescore/transformer.ts"],"sourcesContent":["/**\n * Transforms the raw Sports API livescore response into the canonical\n * {@link FUSportsLivescore} shape.\n */\n\nimport type {\n    FUSportsLivescore,\n    FUSportsLivescoreCompetitionGroup,\n    FUSportsLivescoreEvent,\n    FUSportsLivescoreScore,\n    FUSportsLivescoreStatus,\n} from \"../../../../types/canonical/sports-livescore.types\";\nimport type {\n    RawSportsLivescoreCompetitionGroup,\n    RawSportsLivescoreEvent,\n    RawSportsLivescoreResponse,\n    RawSportsLivescoreScore,\n    RawSportsLivescoreStatus,\n} from \"./types\";\n\nfunction transformStatus(raw: RawSportsLivescoreStatus): FUSportsLivescoreStatus {\n    return {\n        type: raw.type,\n        code: raw.code,\n        subType: raw.sub_type,\n    };\n}\n\nfunction transformScore(raw: RawSportsLivescoreScore): FUSportsLivescoreScore {\n    return {\n        key: raw.key,\n        competitorOne: raw.competitor_one,\n        competitorTwo: raw.competitor_two,\n    };\n}\n\nfunction transformEvent(raw: RawSportsLivescoreEvent): FUSportsLivescoreEvent {\n    return {\n        id: raw.id,\n        status: transformStatus(raw.status),\n        score: raw.score ? raw.score.map(transformScore) : undefined,\n        competitorOne: { id: raw.competitor_one.id, type: raw.competitor_one.type },\n        competitorTwo: { id: raw.competitor_two.id, type: raw.competitor_two.type },\n        startTime: raw.start_time,\n    };\n}\n\nfunction transformGroup(raw: RawSportsLivescoreCompetitionGroup): FUSportsLivescoreCompetitionGroup {\n    return {\n        competitionId: raw.competition_id,\n        sport: raw.sport,\n        events: raw.events.map(transformEvent),\n    };\n}\n\nexport function transformSportsLivescore(raw: RawSportsLivescoreResponse): FUSportsLivescore {\n    return {\n        data: raw.data.map(transformGroup),\n        meta: {\n            totalCompetitions: raw.meta?.total_competitions ?? raw.data.length,\n            totalEvents:\n                raw.meta?.total_events ??\n                raw.data.reduce((sum, group) => sum + group.events.length, 0),\n        },\n    };\n}\n"],"names":[],"mappings":"AAoBA,SAAS,gBAAgB,KAAwD;AAC7E,SAAO;AAAA,IACH,MAAM,IAAI;AAAA,IACV,MAAM,IAAI;AAAA,IACV,SAAS,IAAI;AAAA,EAAA;AAErB;AAEA,SAAS,eAAe,KAAsD;AAC1E,SAAO;AAAA,IACH,KAAK,IAAI;AAAA,IACT,eAAe,IAAI;AAAA,IACnB,eAAe,IAAI;AAAA,EAAA;AAE3B;AAEA,SAAS,eAAe,KAAsD;AAC1E,SAAO;AAAA,IACH,IAAI,IAAI;AAAA,IACR,QAAQ,gBAAgB,IAAI,MAAM;AAAA,IAClC,OAAO,IAAI,QAAQ,IAAI,MAAM,IAAI,cAAc,IAAI;AAAA,IACnD,eAAe,EAAE,IAAI,IAAI,eAAe,IAAI,MAAM,IAAI,eAAe,KAAA;AAAA,IACrE,eAAe,EAAE,IAAI,IAAI,eAAe,IAAI,MAAM,IAAI,eAAe,KAAA;AAAA,IACrE,WAAW,IAAI;AAAA,EAAA;AAEvB;AAEA,SAAS,eAAe,KAA4E;AAChG,SAAO;AAAA,IACH,eAAe,IAAI;AAAA,IACnB,OAAO,IAAI;AAAA,IACX,QAAQ,IAAI,OAAO,IAAI,cAAc;AAAA,EAAA;AAE7C;AAEO,SAAS,yBAAyB,KAAoD;AACzF,SAAO;AAAA,IACH,MAAM,IAAI,KAAK,IAAI,cAAc;AAAA,IACjC,MAAM;AAAA,MACF,mBAAmB,IAAI,MAAM,sBAAsB,IAAI,KAAK;AAAA,MAC5D,aACI,IAAI,MAAM,gBACV,IAAI,KAAK,OAAO,CAAC,KAAK,UAAU,MAAM,MAAM,OAAO,QAAQ,CAAC;AAAA,IAAA;AAAA,EACpE;AAER;"}

package/api/fansunited/sports/livescore/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Raw API response and option types for the Fans United Sports API
+ * livescore endpoint.
+ */
+import type { NextCacheOptions } from "../../http";
+import type { FUSportsLivescoreEventStatus, FUSportsLivescoreSport } from "../../../../types/canonical/sports-livescore.types";
+export interface RawSportsLivescoreStatus {
+    type: string;
+    code: string;
+    sub_type: string;
+}
+export interface RawSportsLivescoreScore {
+    key: string;
+    competitor_one: string;
+    competitor_two: string;
+}
+export interface RawSportsLivescoreCompetitor {
+    id: string;
+    type: string;
+}
+export interface RawSportsLivescoreEvent {
+    id: string;
+    status: RawSportsLivescoreStatus;
+    score?: RawSportsLivescoreScore[];
+    competitor_one: RawSportsLivescoreCompetitor;
+    competitor_two: RawSportsLivescoreCompetitor;
+    start_time: string;
+}
+export interface RawSportsLivescoreCompetitionGroup {
+    competition_id: string;
+    sport: string;
+    events: RawSportsLivescoreEvent[];
+}
+export interface RawSportsLivescoreMeta {
+    total_competitions: number;
+    total_events: number;
+}
+export interface RawSportsLivescoreResponse {
+    data: RawSportsLivescoreCompetitionGroup[];
+    meta: RawSportsLivescoreMeta;
+}
+export interface GetSportsLivescoreOptions {
+    /** Comma-joined or array of competition IDs to filter by. */
+    competitionIds?: string[];
+    /** Match IDs to filter by. */
+    matchIds?: string[];
+    /** Competition IDs defining the order of competition groups in the response. */
+    competitionsOrder?: string[];
+    /** Date in yyyy-MM-dd format. Defaults to the current date (UTC). */
+    date?: string;
+    /** Filter by event status. */
+    eventStatus?: FUSportsLivescoreEventStatus;
+    /** Filter by sport. */
+    sport?: FUSportsLivescoreSport;
+    /** Next.js cache options for ISR/on-demand revalidation. */
+    next?: NextCacheOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/api/fansunited/sports/livescore/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/api/fansunited/sports/livescore/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EACR,4BAA4B,EAC5B,sBAAsB,EACzB,MAAM,oDAAoD,CAAC;AAM5D,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,wBAAwB,CAAC;IACjC,KAAK,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAClC,cAAc,EAAE,4BAA4B,CAAC;IAC7C,cAAc,EAAE,4BAA4B,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kCAAkC;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,kCAAkC,EAAE,CAAC;IAC3C,IAAI,EAAE,sBAAsB,CAAC;CAChC;AAMD,MAAM,WAAW,yBAAyB;IACtC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,WAAW,CAAC,EAAE,4BAA4B,CAAC;IAC3C,uBAAuB;IACvB,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,gBAAgB,CAAC;CAC3B"}

package/cache/__tests__/redis-integration.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Redis L2 integration tests. Skipped unless REDIS_HOST is set, so the
+ * default `npm test` run stays hermetic.
+ *
+ * To run:
+ *   docker compose up -d redis
+ *   REDIS_HOST=redis npm test -- --run src/lib/cache/__tests__/redis-integration.test.ts
+ *
+ * From a host shell (Redis exposed on localhost:6379):
+ *   docker compose up -d redis
+ *   REDIS_HOST=localhost npm test -- --run src/lib/cache/__tests__/redis-integration.test.ts
+ */
+export {};
+//# sourceMappingURL=redis-integration.test.d.ts.map

package/cache/__tests__/redis-integration.test.d.ts.map

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

package/cache/__tests__/redis-l2-store.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Reference Redis L2 adapter — kept under __tests__/ so it ships only with
+ * the dev install (ioredis is a devDependency). Consumers copy this verbatim
+ * (or adapt) into their own codebase per the design spec's "Decision 2":
+ * the Redis client is consumer-supplied so the data-layer stays browser-safe.
+ *
+ * Implementation notes
+ * --------------------
+ *
+ * 1. **Cache envelope.** Each value is a JSON-encoded `CacheEntry<T>`
+ *    (`{ data, storedAt }`). The `storedAt` timestamp is what the cache
+ *    manager uses to decide freshness/expiry — Redis's own TTL is a memory
+ *    safety net, not the source of truth for SWR semantics.
+ *
+ * 2. **Eviction TTL.** Every `set`/`setMany` issues an `EX` matching
+ *    `getEntityTTL(entity).maxTTL`. That keeps Redis from accumulating dead
+ *    entries without needing a periodic cleanup scan. The cache manager
+ *    still defensively rejects entries past `maxTTL` on read via
+ *    `isExpired(entry, maxTTL)`, so the two layers can drift slightly
+ *    without correctness issues.
+ *
+ * 3. **Graceful degradation.** The spec requires that a degraded L2 must
+ *    never throw to the caller. We:
+ *    - report `isInitialized` based on the ioredis status (only `"ready"`
+ *      qualifies);
+ *    - swallow read errors and return `undefined`;
+ *    - swallow write errors and no-op.
+ *    The cache manager will then fall back to L1 + API.
+ *
+ * 4. **`clear()` namespacing.** Uses `SCAN MATCH <prefix>*` + pipelined
+ *    `DEL`. Other keys in the same Redis instance are untouched, which is
+ *    what the `fudl:` prefix is for in the first place.
+ */
+import type { Redis } from "ioredis";
+import type { L2Store } from "../cache-manager";
+export interface RedisL2StoreOptions {
+    /** Connected (or auto-connecting) ioredis client. */
+    client: Redis;
+    /**
+     * Override the prefix used by `clear()` for SCAN. Defaults to the
+     * data-layer's CACHE_KEY_PREFIX so consumers can clear the data-layer's
+     * keys without touching unrelated data in a shared Redis instance.
+     */
+    clearPrefix?: string;
+    /**
+     * Optional logger. Defaults to console. Swap for your structured logger
+     * in production so failures don't get lost in stdout.
+     */
+    log?: (level: "warn" | "error", msg: string, err?: unknown) => void;
+}
+export declare function createRedisL2Store(options: RedisL2StoreOptions): L2Store;
+//# sourceMappingURL=redis-l2-store.d.ts.map

package/cache/__tests__/redis-l2-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-l2-store.d.ts","sourceRoot":"","sources":["../../../src/lib/cache/__tests__/redis-l2-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAUhD,MAAM,WAAW,mBAAmB;IAChC,qDAAqD;IACrD,MAAM,EAAE,KAAK,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACvE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAkFxE"}

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

@@ -0,0 +1,18 @@
+/**
+ * Async in-memory L2 stub. Used by tests that exercise the async L2 path
+ * (Redis adapters are async). Filename intentionally lacks `.test.ts` so
+ * vitest's `src/**\/*.test.ts` glob does not pick it up.
+ */
+import type { L2Store } from "../cache-manager";
+import type { EntityType } from "../types";
+interface StoredRow {
+    entity: EntityType;
+    data: unknown;
+    storedAt: number;
+}
+export declare function createTestL2Store(): L2Store & {
+    reset(): void;
+    raw: Map<string, StoredRow>;
+};
+export {};
+//# sourceMappingURL=test-l2-store.d.ts.map