chore: deduplicated cache stuff

Author: AleksandrSl

cmp/compiler/src/plugin/build-translator.ts

@@ -16,7 +16,7 @@ import {
   type TranslationServer,
 } from "../translation-server";
 import { loadMetadata } from "../metadata/manager";
-import { LocalTranslationCache, type TranslationCache } from "../translators";
+import { createCache, type TranslationCache } from "../translators";
 
 export interface BuildTranslationOptions {
   config: LingoConfig;
@@ -82,10 +82,7 @@ export async function processBuildTranslations(
   const totalEntries = Object.keys(metadata.entries).length;
   logger.info(`📊 Found ${totalEntries} translatable entries`);
 
-  const cache = new LocalTranslationCache(
-    { cacheDir: config.lingoDir },
-    logger,
-  );
+  const cache = createCache(config);
 
   // Handle cache-only mode
   if (buildMode === "cache-only") {
@@ -298,6 +295,7 @@ async function copyStaticFiles(
     const publicFilePath = path.join(publicOutputPath, `${locale}.json`);
 
     try {
+      // TODO (AleksandrSl 14/12/2025): Probably make it required?
       // Use getDictionary if available (for LocalTranslationCache), otherwise use get
       const dictionary = cache.getDictionary
         ? await cache.getDictionary(locale)

cmp/compiler/src/translation-server/translation-server.ts

@@ -18,8 +18,8 @@ import { WebSocket, WebSocketServer } from "ws";
 import type { MetadataSchema, TranslationMiddlewareConfig } from "../types";
 import { getLogger } from "./logger";
 import {
+  createCache,
   createTranslator,
-  LocalTranslationCache,
   TranslationService,
 } from "../translators";
 import {
@@ -92,12 +92,9 @@ export class TranslationServer {
     this.logger.info(`🔧 Initializing translator...`);
 
     const translator = createTranslator(this.config, this.logger);
+    // TODO (AleksandrSl 14/12/2025): I think this should be taken from the translator directly
     const isPseudo = translator.constructor.name === "PseudoTranslator";
-
-    const cache = new LocalTranslationCache(
-      { cacheDir: this.config.lingoDir },
-      this.logger,
-    );
+    const cache = createCache(this.config);
 
     this.translationService = new TranslationService(
       translator,

cmp/compiler/src/translators/cache-factory.ts

@@ -0,0 +1,41 @@
+/**
+ * Cache factory for creating cache instances from config
+ */
+
+import type { LingoConfig, PathConfig } from "../types";
+import type { TranslationCache } from "./cache";
+import { LocalTranslationCache } from "./local-cache";
+import { logger } from "../utils/logger";
+import { getCacheDir } from "../utils/path-helpers";
+
+/**
+ * Create a cache instance based on the config
+ *
+ * @param config - LingoConfig with cacheType and lingoDir
+ * @returns TranslationCache instance
+ *
+ * @example
+ * ```typescript
+ * const cache = createCache(config);
+ * const translations = await cache.get("de");
+ * ```
+ */
+export function createCache(
+  config: Pick<LingoConfig, "cacheType"> & PathConfig,
+): TranslationCache {
+  switch (config.cacheType) {
+    case "local":
+      return new LocalTranslationCache(
+        {
+          cacheDir: getCacheDir(config),
+        },
+        logger,
+      );
+
+    default:
+      // This should never happen due to TypeScript types, but provides a safeguard
+      throw new Error(
+        `Unknown cache type: ${config.cacheType}. Only "local" is currently supported.`,
+      );
+  }
+}

cmp/compiler/src/translators/index.ts

@@ -26,4 +26,4 @@ export type { DictionarySchema } from "./api";
 
 // Cache abstractions
 export type { TranslationCache, LocalCacheConfig } from "./cache";
-export { LocalTranslationCache } from "./local-cache";
+export { createCache } from "./cache-factory";

cmp/compiler/src/translators/pluralization/index.ts

@@ -9,8 +9,6 @@
  */
 export type {
   PluralizationConfig,
-  PartialPluralizationConfig,
-  DefaultPluralizationConfig,
   PluralizationStats,
   PluralCandidate,
   ICUGenerationResult,

cmp/compiler/src/translators/pluralization/types.ts

@@ -1,41 +1,13 @@
-/**
- * Types for pluralization system
- */
+import type { LocaleCode } from "lingo.dev/spec";
 
-import type { LingoConfig } from "../../types";
-
-/**
- * Plural candidate detected by pattern matching
- */
 export interface PluralCandidate {
-  /**
-   * Hash of the entry
-   */
   hash: string;
-
-  /**
-   * Original source text
-   */
   sourceText: string;
 }
 
-/**
- * Result of ICU format generation
- */
 export interface ICUGenerationResult {
-  /**
-   * Whether ICU format was generated successfully
-   */
   success: boolean;
-
-  /**
-   * Generated ICU format text (if successful)
-   */
   icuText?: string;
-
-  /**
-   * Error message (if failed)
-   */
   error?: string;
 
   /**
@@ -44,25 +16,8 @@ export interface ICUGenerationResult {
   reasoning?: string;
 }
 
-type RequiredPluralizationConfigFields = "sourceLocale";
-
-export type DefaultPluralizationConfig = Required<
-  Omit<PluralizationConfig, RequiredPluralizationConfigFields>
->;
-
-export type PartialPluralizationConfig = Partial<
-  Omit<PluralizationConfig, RequiredPluralizationConfigFields>
-> &
-  Pick<PluralizationConfig, RequiredPluralizationConfigFields>;
-
-/**
- * Configuration for pluralization system
- */
 export type PluralizationConfig = {
-  /**
-   * Whether pluralization is enabled
-   * @default true
-   */
+  sourceLocale: LocaleCode;
   enabled: boolean;
 
   /**
@@ -71,7 +26,7 @@ export type PluralizationConfig = {
    * @default "groq:llama3-8b-8192"
    */
   model: string;
-} & Pick<LingoConfig, "sourceLocale">;
+};
 
 /**
  * Statistics about pluralization processing

cmp/compiler/src/translators/translation-service.ts

@@ -11,19 +11,17 @@
 import type { TranslationCache } from "./cache";
 import type { TranslatableEntry, Translator } from "./api";
 import type { MetadataSchema } from "../types";
-import { PluralizationService } from "./pluralization";
+import {
+  type PluralizationConfig,
+  PluralizationService,
+} from "./pluralization";
 import type { Logger } from "../utils/logger";
-import type { PartialPluralizationConfig } from "./pluralization";
 import type { LocaleCode } from "lingo.dev/spec";
 
-/**
- * Configuration for translation service
- */
 export interface TranslationServiceConfig {
   /**
    * Source locale (e.g., "en")
    */
-  // TODO (AleksandrSl 05/12/2025): Sort out these fields, they should most likely pick from the global config
   sourceLocale: LocaleCode;
 
   /**
@@ -36,26 +34,17 @@ export interface TranslationServiceConfig {
    * Pluralization configuration
    * If provided, enables automatic pluralization of source messages
    */
-  pluralization?: Omit<PartialPluralizationConfig, "sourceLocale">;
+  pluralization: Omit<PluralizationConfig, "sourceLocale">;
 }
 
-/**
- * Result of a translation request
- */
 export interface TranslationResult {
   /**
    * Successfully translated entries (hash -> translated text)
    */
   translations: Record<string, string>;
 
-  /**
-   * Errors that occurred during translation
-   */
   errors: TranslationError[];
 
-  /**
-   * Statistics about the operation
-   */
   stats: {
     total: number;
     cached: number;
@@ -64,18 +53,12 @@ export interface TranslationResult {
   };
 }
 
-/**
- * Translation error details
- */
 export interface TranslationError {
   hash: string;
   sourceText: string;
   error: string;
 }
 
-/**
- * Translation service orchestrator
- */
 export class TranslationService {
   private useCache = true;
   private pluralizationService?: PluralizationService;
@@ -94,9 +77,7 @@ export class TranslationService {
       this.logger.info("Initializing pluralization service...");
       this.pluralizationService = new PluralizationService(
         {
-          enabled: true,
-          model:
-            this.config.pluralization?.model || "groq:llama-3.1-8b-instant",
+          ...this.config.pluralization,
           sourceLocale: this.config.sourceLocale,
         },
         this.logger,
@@ -379,6 +360,7 @@ export class TranslationService {
   /**
    * Pick only requested translations from the full set
    */
+  // TODO (AleksandrSl 14/12/2025): SHould I use this in the build somehow?
   private pickTranslations(
     allTranslations: Record<string, string>,
     requestedHashes: string[],

cmp/compiler/src/types.ts

@@ -3,6 +3,7 @@
  */
 
 import type { LocaleCode } from "lingo.dev/spec";
+import type { PluralizationConfig } from "./translators/pluralization";
 
 /**
  * Cookie configuration for locale persistence
@@ -32,7 +33,7 @@ export type LocalePersistenceConfig = { type: "cookie"; cookieName?: string };
  */
 export type LingoConfigRequiredFields = "sourceLocale" | "targetLocales";
 
-export type LingoInternalFields = "environment";
+export type LingoInternalFields = "environment" | "cacheType";
 
 /**
  * Configuration for the Lingo compiler
@@ -47,24 +48,6 @@ export type PartialLingoConfig = Pick<LingoConfig, LingoConfigRequiredFields> &
     }
   >;
 
-/**
- * Pluralization configuration
- */
-export interface PluralizationConfig {
-  /**
-   * Whether pluralization is enabled
-   * @default true
-   */
-  enabled: boolean;
-
-  /**
-   * LLM provider for pluralization detection
-   * Format: "provider:model" (e.g., "groq:llama3-8b-8192")
-   * @default "groq:llama3-8b-8192"
-   */
-  model?: string;
-}
-
 export type LingoEnvironment = "development" | "production";
 
 /**
@@ -86,9 +69,20 @@ export type LingoConfig = {
    * Determines metadata file naming and translator behavior
    *
    * @default "production"
+   * @internal
    */
   environment: LingoEnvironment;
 
+  /**
+   * Cache implementation type
+   * - "local": Local file system cache (default)
+   * - "remote": Remote cache (future)
+   *
+   * @default "local"
+   * @internal Since we do not support more types, there is no need to make it public, but it allows keeping the config in the single place
+   */
+  cacheType: "local";
+
   /**
    * The locale to translate from.
    *
@@ -140,10 +134,8 @@ export type LingoConfig = {
   /**
    * Pluralization configuration
    * Automatically detects and converts messages to ICU MessageFormat
-   *
-   * @default { enabled: true, model: "groq:llama3-8b-8192" }
    */
-  pluralization: PluralizationConfig;
+  pluralization: Omit<PluralizationConfig, "sourceLocale">;
 
   /**
    * Development-specific settings
@@ -227,6 +219,7 @@ export type TranslationMiddlewareConfig = Pick<
   | "dev"
   | "pluralization"
   | "environment"
+  | "cacheType"
 >;
 
 /**