@focus-reactive/payload-plugin-translator 0.1.0

package/dist/server/modules/translation-pipeline/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/server/modules/translation-pipeline/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC/D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/server/modules/translation-pipeline/types/index.js

@@ -0,0 +1,3 @@
+export { isPlainTextChunk, isRichTextChunk } from './TextChunk';
+
+//# sourceMappingURL=index.js.map

package/dist/server/modules/translation-pipeline/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/server/modules/translation-pipeline/types/index.ts"],"sourcesContent":["export type { FieldChunk } from './FieldChunk'\nexport type { PlainTextChunk, RichTextChunk, TextChunk } from './TextChunk'\nexport { isPlainTextChunk, isRichTextChunk } from './TextChunk'\nexport type { PipelineConfig, PipelineResult } from './Pipeline'\nexport type { PipelineContext, PipelineStage } from './PipelineContext'\n"],"names":["isPlainTextChunk","isRichTextChunk"],"mappings":"AAEA,SAASA,gBAAgB,EAAEC,eAAe,QAAQ,cAAa"}

package/dist/server/modules/translation-providers/OpenAITranslation.provider.d.ts

@@ -0,0 +1,128 @@
+import type { TranslationProvider, TranslationInput, TranslationOutput } from './TranslationProvider.interface';
+import { ChatModel } from 'openai/resources/index.mjs';
+/**
+ * Function to transform text in dry run mode.
+ * Receives the original text and returns the transformed text.
+ */
+type DryRunTransformer = (text: string) => string | Promise<string>;
+/**
+ * Configuration for dry run mode with custom transformer.
+ */
+export type DryRunConfig = {
+    /** Custom transformer function for text */
+    transform: DryRunTransformer;
+    /** Delay in milliseconds before returning mock translation (simulates API latency) */
+    timeout?: number;
+};
+/**
+ * Context passed to the system prompt builder function.
+ */
+export type SystemPromptContext = {
+    /** Source language code (e.g., 'en', 'de') */
+    sourceLang: string;
+    /** Target language code (e.g., 'fr', 'es') */
+    targetLang: string;
+    /** Default system prompt that can be extended or replaced */
+    defaultPrompt: string;
+};
+/**
+ * Function to build a custom system prompt for translation.
+ */
+type SystemPromptBuilder = (context: SystemPromptContext) => string;
+export type OpenAIProviderConfig = {
+    apiKey: string;
+    /**
+     * OpenAI model to use for translation.
+     *
+     * @default 'gpt-4o'
+     *
+     * @example
+     * model: 'gpt-4o-mini'
+     */
+    model?: (string & {}) | ChatModel;
+    /**
+     * Custom system prompt builder for translation.
+     * Receives context with source/target languages and the default prompt.
+     *
+     * @example
+     * // Add custom instructions
+     * systemPrompt: ({ sourceLang, targetLang, defaultPrompt }) =>
+     *   `${defaultPrompt}\nUse formal language. Keep brand names unchanged.`
+     *
+     * @example
+     * // Completely custom prompt
+     * systemPrompt: ({ sourceLang, targetLang }) =>
+     *   `Translate JSON values from ${sourceLang} to ${targetLang}. Be concise.`
+     */
+    systemPrompt?: SystemPromptBuilder;
+    /**
+     * When enabled, simulates translations without making actual API calls to OpenAI.
+     *
+     * - `true` — uses default transformer that reverses the text
+     * - `{ transform, timeout? }` — custom transformer with optional delay
+     *
+     * @example
+     * // Default behavior (reverse text, no delay)
+     * dryRun: true
+     *
+     * @example
+     * // Custom transformer with delay
+     * dryRun: {
+     *   transform: (text) => `[TRANSLATED] ${text}`,
+     *   timeout: 1000, // 1 second delay
+     * }
+     *
+     * @default false
+     */
+    dryRun?: boolean | DryRunConfig;
+};
+/** @deprecated Use `createOpenAIProvider` function instead */
+export declare class OpenAITranslationProvider implements TranslationProvider {
+    private readonly config;
+    private openAiClient;
+    constructor(config: OpenAIProviderConfig);
+    translate(content: TranslationInput, souceLng: string, targetLng: string): Promise<TranslationOutput | null>;
+    /**
+     * Builds the system prompt for translation.
+     */
+    private buildSystemPrompt;
+    /**
+     * Returns the transformer function for dry run mode.
+     * If dryRun is an object with transform, returns it.
+     * If dryRun is true, returns the default transformer that reverses text.
+     */
+    private getDryRunTransformer;
+    /**
+     * Returns the timeout for dry run mode.
+     * If dryRun is an object with timeout, returns it.
+     * Otherwise returns 0 (no delay).
+     */
+    private getDryRunTimeout;
+    private createMockTranslation;
+    /**
+     * Recursively transforms the values of an object or array using the provided transformer function.
+     * @param obj The object or value to transform.
+     * @param transformer The function to apply to each value.
+     * @returns The transformed object, array, or value.
+     */
+    private transformObjectValues;
+}
+/**
+ * Creates an OpenAI translation provider.
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * createOpenAIProvider({ apiKey: process.env.OPENAI_API_KEY })
+ *
+ * // With options
+ * createOpenAIProvider({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ *   model: 'gpt-4o-mini',
+ *   systemPrompt: ({ defaultPrompt }) => `${defaultPrompt}\nUse formal language.`,
+ * })
+ * ```
+ */
+export declare function createOpenAIProvider(config: OpenAIProviderConfig): OpenAITranslationProvider;
+export {};
+//# sourceMappingURL=OpenAITranslation.provider.d.ts.map

package/dist/server/modules/translation-providers/OpenAITranslation.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAITranslation.provider.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/translation-providers/OpenAITranslation.provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAE/G,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEtD;;;GAGG;AACH,KAAK,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;AAEnE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,2CAA2C;IAC3C,SAAS,EAAE,iBAAiB,CAAA;IAC5B,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;GAEG;AACH,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,MAAM,CAAA;AAEnE,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,SAAS,CAAA;IACjC;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,YAAY,CAAA;CAChC,CAAA;AAED,8DAA8D;AAC9D,qBAAa,yBAA0B,YAAW,mBAAmB;IAGvD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,YAAY,CAAQ;gBAEC,MAAM,EAAE,oBAAoB;IAInD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAyClH;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;YAOV,qBAAqB;IAgBnC;;;;;OAKG;YACW,qBAAqB;CAkBpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,yBAAyB,CAE5F"}

package/dist/server/modules/translation-providers/OpenAITranslation.provider.js

@@ -0,0 +1,138 @@
+import OpenAI from 'openai';
+import { isObject } from '../../shared';
+/** @deprecated Use `createOpenAIProvider` function instead */ export class OpenAITranslationProvider {
+    config;
+    openAiClient;
+    constructor(config){
+        this.config = config;
+        this.openAiClient = new OpenAI({
+            apiKey: config.apiKey
+        });
+    }
+    async translate(content, souceLng, targetLng) {
+        if (this.config.dryRun) {
+            console.info('[DRY RUN] Translation simulation:', {
+                content,
+                sourceLang: souceLng,
+                targetLang: targetLng,
+                provider: 'OpenAI'
+            });
+            const timeout = this.getDryRunTimeout();
+            if (timeout > 0) await new Promise((resolve)=>setTimeout(resolve, timeout));
+            const transformer = this.getDryRunTransformer();
+            return this.createMockTranslation(content, transformer);
+        }
+        const systemPrompt = this.buildSystemPrompt(souceLng, targetLng);
+        const chatCompletion = await this.openAiClient.chat.completions.create({
+            messages: [
+                {
+                    role: 'system',
+                    content: systemPrompt
+                },
+                {
+                    role: 'user',
+                    content: JSON.stringify(content)
+                }
+            ],
+            model: this.config.model ?? 'gpt-4o',
+            temperature: 0,
+            top_p: 1,
+            frequency_penalty: 0,
+            presence_penalty: 0,
+            response_format: {
+                type: 'json_object'
+            }
+        });
+        const translatedContent = chatCompletion.choices[0].message.content;
+        if (!translatedContent) return null;
+        try {
+            return JSON.parse(translatedContent);
+        } catch  {
+            return null;
+        }
+    }
+    /**
+   * Builds the system prompt for translation.
+   */ buildSystemPrompt(sourceLang, targetLang) {
+        const defaultPrompt = `Translate the values from the JSON that the user will send you${sourceLang ? ` from ${sourceLang}` : ''} into ${targetLang}. Keep all JSON keys exactly as they are, only translate the values.
+The response should be a valid JSON object with the same structure and keys as the input, but with translated values.
+Maintain any special formatting, placeholders, or variables within the values if they exist.`;
+        if (this.config.systemPrompt) {
+            return this.config.systemPrompt({
+                sourceLang,
+                targetLang,
+                defaultPrompt
+            });
+        }
+        return defaultPrompt;
+    }
+    /**
+   * Returns the transformer function for dry run mode.
+   * If dryRun is an object with transform, returns it.
+   * If dryRun is true, returns the default transformer that reverses text.
+   */ getDryRunTransformer() {
+        if (typeof this.config.dryRun === 'object' && this.config.dryRun.transform) {
+            return this.config.dryRun.transform;
+        }
+        return (text)=>text.split('').reverse().join('');
+    }
+    /**
+   * Returns the timeout for dry run mode.
+   * If dryRun is an object with timeout, returns it.
+   * Otherwise returns 0 (no delay).
+   */ getDryRunTimeout() {
+        if (typeof this.config.dryRun === 'object' && this.config.dryRun.timeout) {
+            return this.config.dryRun.timeout;
+        }
+        return 0;
+    }
+    async createMockTranslation(content, transformer) {
+        try {
+            const mockTranslation = await this.transformObjectValues(content, async (value)=>{
+                if (typeof value === 'string' && value.trim()) return transformer(value);
+                return value;
+            });
+            return mockTranslation;
+        } catch  {
+            return null;
+        }
+    }
+    /**
+   * Recursively transforms the values of an object or array using the provided transformer function.
+   * @param obj The object or value to transform.
+   * @param transformer The function to apply to each value.
+   * @returns The transformed object, array, or value.
+   */ async transformObjectValues(obj, transformer) {
+        if (Array.isArray(obj)) {
+            return Promise.all(obj.map((item)=>this.transformObjectValues(item, transformer)));
+        }
+        if (isObject(obj)) {
+            const result = {};
+            for (const [key, value] of Object.entries(obj)){
+                result[key] = await this.transformObjectValues(value, transformer);
+            }
+            return result;
+        }
+        return transformer(obj);
+    }
+}
+/**
+ * Creates an OpenAI translation provider.
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * createOpenAIProvider({ apiKey: process.env.OPENAI_API_KEY })
+ *
+ * // With options
+ * createOpenAIProvider({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ *   model: 'gpt-4o-mini',
+ *   systemPrompt: ({ defaultPrompt }) => `${defaultPrompt}\nUse formal language.`,
+ * })
+ * ```
+ */ export function createOpenAIProvider(config) {
+    return new OpenAITranslationProvider(config);
+}
+
+//# sourceMappingURL=OpenAITranslation.provider.js.map

package/dist/server/modules/translation-providers/OpenAITranslation.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/modules/translation-providers/OpenAITranslation.provider.ts"],"sourcesContent":["import OpenAI from 'openai'\n\nimport type { TranslationProvider, TranslationInput, TranslationOutput } from './TranslationProvider.interface'\nimport { isObject } from '../../shared'\nimport { ChatModel } from 'openai/resources/index.mjs'\n\n/**\n * Function to transform text in dry run mode.\n * Receives the original text and returns the transformed text.\n */\ntype DryRunTransformer = (text: string) => string | Promise<string>\n\n/**\n * Configuration for dry run mode with custom transformer.\n */\nexport type DryRunConfig = {\n  /** Custom transformer function for text */\n  transform: DryRunTransformer\n  /** Delay in milliseconds before returning mock translation (simulates API latency) */\n  timeout?: number\n}\n\n/**\n * Context passed to the system prompt builder function.\n */\nexport type SystemPromptContext = {\n  /** Source language code (e.g., 'en', 'de') */\n  sourceLang: string\n  /** Target language code (e.g., 'fr', 'es') */\n  targetLang: string\n  /** Default system prompt that can be extended or replaced */\n  defaultPrompt: string\n}\n\n/**\n * Function to build a custom system prompt for translation.\n */\ntype SystemPromptBuilder = (context: SystemPromptContext) => string\n\nexport type OpenAIProviderConfig = {\n  apiKey: string\n  /**\n   * OpenAI model to use for translation.\n   *\n   * @default 'gpt-4o'\n   *\n   * @example\n   * model: 'gpt-4o-mini'\n   */\n  model?: (string & {}) | ChatModel\n  /**\n   * Custom system prompt builder for translation.\n   * Receives context with source/target languages and the default prompt.\n   *\n   * @example\n   * // Add custom instructions\n   * systemPrompt: ({ sourceLang, targetLang, defaultPrompt }) =>\n   *   `${defaultPrompt}\\nUse formal language. Keep brand names unchanged.`\n   *\n   * @example\n   * // Completely custom prompt\n   * systemPrompt: ({ sourceLang, targetLang }) =>\n   *   `Translate JSON values from ${sourceLang} to ${targetLang}. Be concise.`\n   */\n  systemPrompt?: SystemPromptBuilder\n  /**\n   * When enabled, simulates translations without making actual API calls to OpenAI.\n   *\n   * - `true` — uses default transformer that reverses the text\n   * - `{ transform, timeout? }` — custom transformer with optional delay\n   *\n   * @example\n   * // Default behavior (reverse text, no delay)\n   * dryRun: true\n   *\n   * @example\n   * // Custom transformer with delay\n   * dryRun: {\n   *   transform: (text) => `[TRANSLATED] ${text}`,\n   *   timeout: 1000, // 1 second delay\n   * }\n   *\n   * @default false\n   */\n  dryRun?: boolean | DryRunConfig\n}\n\n/** @deprecated Use `createOpenAIProvider` function instead */\nexport class OpenAITranslationProvider implements TranslationProvider {\n  private openAiClient: OpenAI\n\n  constructor(private readonly config: OpenAIProviderConfig) {\n    this.openAiClient = new OpenAI({ apiKey: config.apiKey })\n  }\n\n  async translate(content: TranslationInput, souceLng: string, targetLng: string): Promise<TranslationOutput | null> {\n    if (this.config.dryRun) {\n      console.info('[DRY RUN] Translation simulation:', {\n        content,\n        sourceLang: souceLng,\n        targetLang: targetLng,\n        provider: 'OpenAI',\n      })\n\n      const timeout = this.getDryRunTimeout()\n      if (timeout > 0) await new Promise((resolve) => setTimeout(resolve, timeout))\n\n      const transformer = this.getDryRunTransformer()\n      return this.createMockTranslation(content, transformer)\n    }\n\n    const systemPrompt = this.buildSystemPrompt(souceLng, targetLng)\n\n    const chatCompletion = await this.openAiClient.chat.completions.create({\n      messages: [\n        { role: 'system', content: systemPrompt },\n        { role: 'user', content: JSON.stringify(content) },\n      ],\n      model: this.config.model ?? 'gpt-4o',\n      temperature: 0,\n      top_p: 1,\n      frequency_penalty: 0,\n      presence_penalty: 0,\n      response_format: { type: 'json_object' },\n    })\n\n    const translatedContent = chatCompletion.choices[0].message.content\n    if (!translatedContent) return null\n\n    try {\n      return JSON.parse(translatedContent)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Builds the system prompt for translation.\n   */\n  private buildSystemPrompt(sourceLang: string, targetLang: string): string {\n    const defaultPrompt = `Translate the values from the JSON that the user will send you${sourceLang ? ` from ${sourceLang}` : ''} into ${targetLang}. Keep all JSON keys exactly as they are, only translate the values.\nThe response should be a valid JSON object with the same structure and keys as the input, but with translated values.\nMaintain any special formatting, placeholders, or variables within the values if they exist.`\n\n    if (this.config.systemPrompt) {\n      return this.config.systemPrompt({ sourceLang, targetLang, defaultPrompt })\n    }\n\n    return defaultPrompt\n  }\n\n  /**\n   * Returns the transformer function for dry run mode.\n   * If dryRun is an object with transform, returns it.\n   * If dryRun is true, returns the default transformer that reverses text.\n   */\n  private getDryRunTransformer(): DryRunTransformer {\n    if (typeof this.config.dryRun === 'object' && this.config.dryRun.transform) {\n      return this.config.dryRun.transform\n    }\n    return (text: string) => text.split('').reverse().join('')\n  }\n\n  /**\n   * Returns the timeout for dry run mode.\n   * If dryRun is an object with timeout, returns it.\n   * Otherwise returns 0 (no delay).\n   */\n  private getDryRunTimeout(): number {\n    if (typeof this.config.dryRun === 'object' && this.config.dryRun.timeout) {\n      return this.config.dryRun.timeout\n    }\n    return 0\n  }\n\n  private async createMockTranslation(\n    content: TranslationInput,\n    transformer: DryRunTransformer,\n  ): Promise<TranslationOutput | null> {\n    try {\n      const mockTranslation = await this.transformObjectValues(content, async (value) => {\n        if (typeof value === 'string' && value.trim()) return transformer(value)\n        return value\n      })\n\n      return mockTranslation as TranslationOutput\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Recursively transforms the values of an object or array using the provided transformer function.\n   * @param obj The object or value to transform.\n   * @param transformer The function to apply to each value.\n   * @returns The transformed object, array, or value.\n   */\n  private async transformObjectValues(\n    obj: unknown,\n    transformer: (value: unknown) => unknown | Promise<unknown>,\n  ): Promise<unknown> {\n    if (Array.isArray(obj)) {\n      return Promise.all(obj.map((item) => this.transformObjectValues(item, transformer)))\n    }\n\n    if (isObject(obj)) {\n      const result: Record<string, unknown> = {}\n      for (const [key, value] of Object.entries(obj)) {\n        result[key] = await this.transformObjectValues(value, transformer)\n      }\n      return result\n    }\n\n    return transformer(obj)\n  }\n}\n\n/**\n * Creates an OpenAI translation provider.\n *\n * @example\n * ```ts\n * // Basic usage\n * createOpenAIProvider({ apiKey: process.env.OPENAI_API_KEY })\n *\n * // With options\n * createOpenAIProvider({\n *   apiKey: process.env.OPENAI_API_KEY,\n *   model: 'gpt-4o-mini',\n *   systemPrompt: ({ defaultPrompt }) => `${defaultPrompt}\\nUse formal language.`,\n * })\n * ```\n */\nexport function createOpenAIProvider(config: OpenAIProviderConfig): OpenAITranslationProvider {\n  return new OpenAITranslationProvider(config)\n}\n"],"names":["OpenAI","isObject","OpenAITranslationProvider","openAiClient","config","apiKey","translate","content","souceLng","targetLng","dryRun","console","info","sourceLang","targetLang","provider","timeout","getDryRunTimeout","Promise","resolve","setTimeout","transformer","getDryRunTransformer","createMockTranslation","systemPrompt","buildSystemPrompt","chatCompletion","chat","completions","create","messages","role","JSON","stringify","model","temperature","top_p","frequency_penalty","presence_penalty","response_format","type","translatedContent","choices","message","parse","defaultPrompt","transform","text","split","reverse","join","mockTranslation","transformObjectValues","value","trim","obj","Array","isArray","all","map","item","result","key","Object","entries","createOpenAIProvider"],"mappings":"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"}

package/dist/server/modules/translation-providers/OpenAITranslation.provider.test.d.ts

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

package/dist/server/modules/translation-providers/OpenAITranslation.provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAITranslation.provider.test.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/translation-providers/OpenAITranslation.provider.test.ts"],"names":[],"mappings":""}

package/dist/server/modules/translation-providers/OpenAITranslation.provider.test.js

@@ -0,0 +1,214 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { OpenAITranslationProvider } from './OpenAITranslation.provider';
+// Mock OpenAI
+vi.mock('openai', () => ({
+    default: vi.fn().mockImplementation(() => ({
+        chat: {
+            completions: {
+                create: vi.fn(),
+            },
+        },
+    })),
+}));
+describe('OpenAITranslationProvider', () => {
+    let provider;
+    let mockCreate;
+    beforeEach(async () => {
+        vi.clearAllMocks();
+        // Get the mocked OpenAI class
+        const OpenAI = (await import('openai')).default;
+        mockCreate = vi.fn();
+        OpenAI.mockImplementation(() => ({
+            chat: {
+                completions: {
+                    create: mockCreate,
+                },
+            },
+        }));
+        provider = new OpenAITranslationProvider({ apiKey: 'test-api-key' });
+    });
+    describe('translate', () => {
+        it('calls OpenAI API with correct parameters', async () => {
+            mockCreate.mockResolvedValue({
+                choices: [{ message: { content: '{"0": "Hallo"}' } }],
+            });
+            await provider.translate({ 0: 'Hello' }, 'en', 'de');
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                model: 'gpt-4o',
+                temperature: 0,
+                response_format: { type: 'json_object' },
+                messages: expect.arrayContaining([
+                    expect.objectContaining({ role: 'system' }),
+                    expect.objectContaining({
+                        role: 'user',
+                        content: '{"0":"Hello"}',
+                    }),
+                ]),
+            }));
+        });
+        it('returns parsed JSON response', async () => {
+            mockCreate.mockResolvedValue({
+                choices: [{ message: { content: '{"0": "Titel", "1": "Inhalt"}' } }],
+            });
+            const result = await provider.translate({ 0: 'Title', 1: 'Content' }, 'en', 'de');
+            expect(result).toEqual({ 0: 'Titel', 1: 'Inhalt' });
+        });
+        it('returns null when API returns empty content', async () => {
+            mockCreate.mockResolvedValue({
+                choices: [{ message: { content: null } }],
+            });
+            const result = await provider.translate({ 0: 'Hello' }, 'en', 'de');
+            expect(result).toBeNull();
+        });
+        it('returns null when API returns invalid JSON', async () => {
+            mockCreate.mockResolvedValue({
+                choices: [{ message: { content: 'not valid json' } }],
+            });
+            const result = await provider.translate({ 0: 'Hello' }, 'en', 'de');
+            expect(result).toBeNull();
+        });
+        it('includes source language in system prompt when provided', async () => {
+            mockCreate.mockResolvedValue({
+                choices: [{ message: { content: '{}' } }],
+            });
+            await provider.translate({ 0: 'Hello' }, 'en', 'de');
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                messages: expect.arrayContaining([
+                    expect.objectContaining({
+                        role: 'system',
+                        content: expect.stringContaining('from en'),
+                    }),
+                ]),
+            }));
+        });
+    });
+    describe('dryRun mode', () => {
+        describe('with dryRun: true (default transformer, no delay)', () => {
+            beforeEach(async () => {
+                provider = new OpenAITranslationProvider({ apiKey: 'test-key', dryRun: true });
+            });
+            it('does not call OpenAI API in dry run mode', async () => {
+                await provider.translate({ 0: 'Hello' }, 'en', 'de');
+                expect(mockCreate).not.toHaveBeenCalled();
+            });
+            it('returns mock translation with reversed text', async () => {
+                const result = await provider.translate({ 0: 'Hello World' }, 'en', 'de');
+                expect(result).toEqual({ 0: 'dlroW olleH' });
+            });
+            it('handles multiple indexed entries in dry run', async () => {
+                const content = {
+                    0: 'First text',
+                    1: 'Second text',
+                    2: 'Third text',
+                };
+                const result = await provider.translate(content, 'en', 'fr');
+                expect(result).toEqual({
+                    0: 'txet tsriF',
+                    1: 'txet dnoceS',
+                    2: 'txet drihT',
+                });
+            });
+            it('preserves empty strings in dry run', async () => {
+                const content = {
+                    0: 'Hello',
+                    1: '',
+                    2: 'World',
+                };
+                const result = await provider.translate(content, 'en', 'de');
+                expect(result).toEqual({
+                    0: 'olleH',
+                    1: '',
+                    2: 'dlroW',
+                });
+            });
+            it('handles whitespace-only strings in dry run', async () => {
+                const content = {
+                    0: 'Hello',
+                    1: '   ',
+                    2: 'World',
+                };
+                const result = await provider.translate(content, 'en', 'de');
+                // Whitespace-only strings are not transformed (value.trim() is empty)
+                expect(result).toEqual({
+                    0: 'olleH',
+                    1: '   ',
+                    2: 'dlroW',
+                });
+            });
+        });
+        describe('with custom transformer config', () => {
+            it('uses custom transformer function', async () => {
+                provider = new OpenAITranslationProvider({
+                    apiKey: 'test-key',
+                    dryRun: {
+                        transform: (text) => `[TRANSLATED] ${text}`,
+                    },
+                });
+                const result = await provider.translate({ 0: 'Hello World' }, 'en', 'de');
+                expect(result).toEqual({ 0: '[TRANSLATED] Hello World' });
+            });
+            it('uses custom transformer for multiple entries', async () => {
+                provider = new OpenAITranslationProvider({
+                    apiKey: 'test-key',
+                    dryRun: {
+                        transform: (text) => text.toUpperCase(),
+                    },
+                });
+                const content = {
+                    0: 'hello',
+                    1: 'world',
+                };
+                const result = await provider.translate(content, 'en', 'fr');
+                expect(result).toEqual({
+                    0: 'HELLO',
+                    1: 'WORLD',
+                });
+            });
+            it('does not call OpenAI API with custom transformer', async () => {
+                provider = new OpenAITranslationProvider({
+                    apiKey: 'test-key',
+                    dryRun: {
+                        transform: (text) => `mock: ${text}`,
+                    },
+                });
+                await provider.translate({ 0: 'Test' }, 'en', 'de');
+                expect(mockCreate).not.toHaveBeenCalled();
+            });
+            it('respects timeout option', async () => {
+                vi.useFakeTimers();
+                provider = new OpenAITranslationProvider({
+                    apiKey: 'test-key',
+                    dryRun: {
+                        transform: (text) => `[T] ${text}`,
+                        timeout: 1000,
+                    },
+                });
+                const translatePromise = provider.translate({ 0: 'Hello' }, 'en', 'de');
+                // Should not resolve immediately
+                await vi.advanceTimersByTimeAsync(500);
+                // Advance past timeout
+                await vi.advanceTimersByTimeAsync(600);
+                const result = await translatePromise;
+                expect(result).toEqual({ 0: '[T] Hello' });
+                vi.useRealTimers();
+            });
+            it('supports async transformer function', async () => {
+                provider = new OpenAITranslationProvider({
+                    apiKey: 'test-key',
+                    dryRun: {
+                        transform: async (text) => {
+                            // Simulate async operation (e.g., external API call)
+                            await new Promise((resolve) => setTimeout(resolve, 10));
+                            return `[ASYNC] ${text}`;
+                        },
+                    },
+                });
+                const result = await provider.translate({ 0: 'Hello', 1: 'World' }, 'en', 'de');
+                expect(result).toEqual({
+                    0: '[ASYNC] Hello',
+                    1: '[ASYNC] World',
+                });
+            });
+        });
+    });
+});

package/dist/server/modules/translation-providers/TranslationProvider.interface.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Numeric index used as key in translation input and output.
+ * Represents the position of text in the original document structure.
+ */
+export type TranslationIndex = number;
+/**
+ * Input map of text content for translation.
+ * Keys are numeric indices that must be preserved in the output.
+ * Values are the text strings to translate.
+ *
+ * @example
+ * { 0: "Hello", 1: "World", 2: "Welcome to our site" }
+ */
+export type TranslationInput = Record<TranslationIndex, string>;
+/**
+ * Output of translation operation.
+ * Must have the same keys as input, with translated values.
+ *
+ * @example
+ * // Input: { 0: "Hello", 1: "World" }
+ * // Output: { 0: "Привет", 1: "Мир" }
+ */
+export type TranslationOutput = Record<TranslationIndex, string>;
+/**
+ * Interface for translation service providers.
+ *
+ * Implementations must:
+ * - Preserve all numeric keys from input
+ * - Return translated text values for each key
+ * - Return null on translation failure
+ * - Handle empty input gracefully
+ *
+ * @example
+ * ```typescript
+ * class MyProvider implements TranslationProvider {
+ *   async translate(input, sourceLng, targetLng) {
+ *     // Input:  { 0: "Hello", 1: "World" }
+ *     // Output: { 0: "Bonjour", 1: "Monde" }
+ *     const output = await myTranslationAPI.translate(input, targetLng)
+ *     return output
+ *   }
+ * }
+ * ```
+ */
+export interface TranslationProvider {
+    /**
+     * Translates indexed text content from source to target language.
+     *
+     * @param input - Map of index to text string. Keys must be preserved in output.
+     * @param sourceLng - Source language code (e.g., 'en', 'de'). May be empty for auto-detect.
+     * @param targetLng - Target language code (e.g., 'fr', 'es').
+     * @returns Translated output with same keys, or null on failure.
+     */
+    translate(input: TranslationInput, sourceLng: string, targetLng: string): Promise<TranslationOutput | null>;
+}
+//# sourceMappingURL=TranslationProvider.interface.d.ts.map

package/dist/server/modules/translation-providers/TranslationProvider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationProvider.interface.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/translation-providers/TranslationProvider.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAA;AAErC;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;AAE/D;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;AAEhE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;CAC5G"}

package/dist/server/modules/translation-providers/TranslationProvider.interface.js

@@ -0,0 +1,26 @@
+/**
+ * Numeric index used as key in translation input and output.
+ * Represents the position of text in the original document structure.
+ */ /**
+ * Interface for translation service providers.
+ *
+ * Implementations must:
+ * - Preserve all numeric keys from input
+ * - Return translated text values for each key
+ * - Return null on translation failure
+ * - Handle empty input gracefully
+ *
+ * @example
+ * ```typescript
+ * class MyProvider implements TranslationProvider {
+ *   async translate(input, sourceLng, targetLng) {
+ *     // Input:  { 0: "Hello", 1: "World" }
+ *     // Output: { 0: "Bonjour", 1: "Monde" }
+ *     const output = await myTranslationAPI.translate(input, targetLng)
+ *     return output
+ *   }
+ * }
+ * ```
+ */ export { };
+
+//# sourceMappingURL=TranslationProvider.interface.js.map

package/dist/server/modules/translation-providers/TranslationProvider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/modules/translation-providers/TranslationProvider.interface.ts"],"sourcesContent":["/**\n * Numeric index used as key in translation input and output.\n * Represents the position of text in the original document structure.\n */\nexport type TranslationIndex = number\n\n/**\n * Input map of text content for translation.\n * Keys are numeric indices that must be preserved in the output.\n * Values are the text strings to translate.\n *\n * @example\n * { 0: \"Hello\", 1: \"World\", 2: \"Welcome to our site\" }\n */\nexport type TranslationInput = Record<TranslationIndex, string>\n\n/**\n * Output of translation operation.\n * Must have the same keys as input, with translated values.\n *\n * @example\n * // Input: { 0: \"Hello\", 1: \"World\" }\n * // Output: { 0: \"Привет\", 1: \"Мир\" }\n */\nexport type TranslationOutput = Record<TranslationIndex, string>\n\n/**\n * Interface for translation service providers.\n *\n * Implementations must:\n * - Preserve all numeric keys from input\n * - Return translated text values for each key\n * - Return null on translation failure\n * - Handle empty input gracefully\n *\n * @example\n * ```typescript\n * class MyProvider implements TranslationProvider {\n *   async translate(input, sourceLng, targetLng) {\n *     // Input:  { 0: \"Hello\", 1: \"World\" }\n *     // Output: { 0: \"Bonjour\", 1: \"Monde\" }\n *     const output = await myTranslationAPI.translate(input, targetLng)\n *     return output\n *   }\n * }\n * ```\n */\nexport interface TranslationProvider {\n  /**\n   * Translates indexed text content from source to target language.\n   *\n   * @param input - Map of index to text string. Keys must be preserved in output.\n   * @param sourceLng - Source language code (e.g., 'en', 'de'). May be empty for auto-detect.\n   * @param targetLng - Target language code (e.g., 'fr', 'es').\n   * @returns Translated output with same keys, or null on failure.\n   */\n  translate(input: TranslationInput, sourceLng: string, targetLng: string): Promise<TranslationOutput | null>\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAuBD;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,WAUC"}

package/dist/server/modules/translation-providers/index.d.ts

@@ -0,0 +1,3 @@
+export type { TranslationProvider, TranslationInput, TranslationOutput, TranslationIndex, } from './TranslationProvider.interface';
+export { OpenAITranslationProvider, createOpenAIProvider, type OpenAIProviderConfig, type DryRunConfig, type SystemPromptContext, } from './OpenAITranslation.provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/modules/translation-providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/translation-providers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,8BAA8B,CAAA"}

package/dist/server/modules/translation-providers/index.js

@@ -0,0 +1,3 @@
+export { OpenAITranslationProvider, createOpenAIProvider } from './OpenAITranslation.provider';
+
+//# sourceMappingURL=index.js.map

package/dist/server/modules/translation-providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/modules/translation-providers/index.ts"],"sourcesContent":["export type {\n  TranslationProvider,\n  TranslationInput,\n  TranslationOutput,\n  TranslationIndex,\n} from './TranslationProvider.interface'\nexport {\n  OpenAITranslationProvider,\n  createOpenAIProvider,\n  type OpenAIProviderConfig,\n  type DryRunConfig,\n  type SystemPromptContext,\n} from './OpenAITranslation.provider'\n"],"names":["OpenAITranslationProvider","createOpenAIProvider"],"mappings":"AAMA,SACEA,yBAAyB,EACzBC,oBAAoB,QAIf,+BAA8B"}

package/dist/server/shared/access/AnyAccessGuard.d.ts

@@ -0,0 +1,8 @@
+import type { AccessGuard } from './types';
+/**
+ * Default access guard that allows all requests
+ */
+export declare class AnyAccessGuard implements AccessGuard {
+    check(): Promise<boolean>;
+}
+//# sourceMappingURL=AnyAccessGuard.d.ts.map

package/dist/server/shared/access/AnyAccessGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnyAccessGuard.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/access/AnyAccessGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IAC1C,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;CAGhC"}