@focus-reactive/payload-plugin-translator 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 FocusReactive
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,410 @@
+# @focus-reactive/payload-plugin-translator
+
+Translation plugin for Payload CMS 3.x. Automatically translate your localized content using any translation provider.
+
+## Features
+
+- **Deep translation** — translates all localized fields at any nesting level (groups, arrays, blocks, tabs)
+- **Rich text support** — full Lexical rich text translation preserving formatting and structure
+- **Bulk translation** — translate multiple documents at once from collection list view
+- **Progress tracking** — real-time translation status indicators in admin UI
+- **Async processing** — queue-based background jobs (Payload Jobs) or synchronous mode
+- **Pluggable providers** — use OpenAI or create custom translation providers
+- **Field exclusion** — exclude specific fields from translation via `withFieldTranslation`
+- **Translation strategies** — choose between overwrite all or skip existing translations
+
+## Installation
+
+```bash
+# pnpm
+pnpm add @focus-reactive/payload-plugin-translator
+
+# npm
+npm install @focus-reactive/payload-plugin-translator
+
+# yarn
+yarn add @focus-reactive/payload-plugin-translator
+```
+
+## Quick Start
+
+```typescript
+import { buildConfig } from 'payload'
+import {
+  translatorPlugin,
+  createOpenAIProvider,
+  createPayloadJobsRunner,
+} from '@focus-reactive/payload-plugin-translator'
+import { Posts } from './collections/Posts'
+import { Pages } from './collections/Pages'
+
+export default buildConfig({
+  collections: [Posts, Pages],
+  plugins: [
+    translatorPlugin({
+      collections: [Posts, Pages],
+      translationProvider: createOpenAIProvider({
+        apiKey: process.env.OPENAI_API_KEY,
+      }),
+      runner: createPayloadJobsRunner(),
+    }),
+  ],
+  localization: {
+    locales: ['en', 'de', 'fr'],
+    defaultLocale: 'en',
+  },
+})
+```
+
+## Configuration
+
+### TranslatorPluginConfig
+
+Configuration for `translatorPlugin()`.
+
+| Property              | Type                  | Required | Default        | Description                                                                                                         |
+| --------------------- | --------------------- | -------- | -------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `collections`         | `CollectionConfig[]`  | Yes      | —              | Original collection configs to enable translation for. Must be the same objects passed to `buildConfig`, not slugs. |
+| `translationProvider` | `TranslationProvider` | Yes      | —              | Translation provider instance (e.g., `createOpenAIProvider(...)`)                                                   |
+| `runner`              | `TaskRunnerProvider`  | Yes      | —              | Task runner provider for background processing (e.g., `createPayloadJobsRunner()`)                                  |
+| `access`              | `AccessGuard`         | No       | `undefined`    | Access control function for translation endpoints                                                                   |
+| `basePath`            | `string`              | No       | `'/translate'` | Base path for all API endpoints                                                                                     |
+
+```typescript
+translatorPlugin({
+  collections: [Posts, Pages],
+  translationProvider: createOpenAIProvider({ apiKey: process.env.OPENAI_API_KEY }),
+  runner: createPayloadJobsRunner(),
+  access: async ({ req }) => req.user?.role === 'admin',
+  basePath: '/translate',
+})
+```
+
+### OpenAIProviderConfig
+
+Configuration for `createOpenAIProvider()`.
+
+| Property       | Type                  | Required      | Default         | Description                                |
+| -------------- | --------------------- | ------------- | --------------- | ------------------------------------------ | --------------------------------------- |
+| `apiKey`       | `string`              | Yes           | —               | OpenAI API key                             |
+| `model`        | `string               | ChatModel`    | No              | `'gpt-4o'`                                 | OpenAI model to use for translation     |
+| `systemPrompt` | `SystemPromptBuilder` | No            | Built-in prompt | Custom function to build the system prompt |
+| `dryRun`       | `boolean              | DryRunConfig` | No              | `false`                                    | Simulate translations without API calls |
+
+```typescript
+createOpenAIProvider({
+  apiKey: process.env.OPENAI_API_KEY,
+  model: 'gpt-4o-mini',
+  systemPrompt: ({ sourceLang, targetLang, defaultPrompt }) =>
+    `${defaultPrompt}\nUse formal language. Keep brand names unchanged.`,
+  dryRun: false,
+})
+```
+
+#### SystemPromptBuilder
+
+Function signature for custom system prompt:
+
+```typescript
+type SystemPromptBuilder = (context: SystemPromptContext) => string
+
+type SystemPromptContext = {
+  sourceLang: string
+  targetLang: string
+  defaultPrompt: string
+}
+```
+
+#### DryRunConfig
+
+When `dryRun` is an object, it allows custom transformation with optional delay:
+
+```typescript
+type DryRunTransformer = (text: string) => string | Promise<string>
+
+type DryRunConfig = {
+  transform: DryRunTransformer // Custom transformer function
+  timeout?: number // Delay in ms (simulates API latency)
+}
+```
+
+### PayloadJobsRunnerOptions
+
+Configuration for `createPayloadJobsRunner()`.
+
+| Property    | Type     | Required         | Default                | Description                          |
+| ----------- | -------- | ---------------- | ---------------------- | ------------------------------------ | ------------------------------------------------------- |
+| `taskName`  | `string` | No               | `'translate_document'` | Task name in Payload jobs collection |
+| `queueName` | `string` | No               | `'translations'`       | Queue name for grouping jobs         |
+| `autoRun`   | `false   | { cron, limit }` | No                     | `{ cron: '* * * * *', limit: 50 }`   | Auto-run config, or `false` to disable (for serverless) |
+
+```typescript
+createPayloadJobsRunner({
+  taskName: 'translate_document',
+  queueName: 'translations',
+  autoRun: {
+    cron: '* * * * *',
+    limit: 50,
+  },
+})
+```
+
+### FieldTranslationConfig
+
+Configuration for `withFieldTranslation()` helper or `field.custom.translateKit`.
+
+| Property  | Type      | Required | Default | Description                         |
+| --------- | --------- | -------- | ------- | ----------------------------------- |
+| `exclude` | `boolean` | No       | `false` | Exclude this field from translation |
+
+```typescript
+import { withFieldTranslation } from '@focus-reactive/payload-plugin-translator'
+
+withFieldTranslation({ name: 'sku', type: 'text', localized: true }, { exclude: true })
+```
+
+## Translation Strategies
+
+When translating, you can choose how to handle existing translations:
+
+| Strategy          | Description                                                              |
+| ----------------- | ------------------------------------------------------------------------ |
+| `'overwrite'`     | (Default) Replaces all existing translated content with new translations |
+| `'skip_existing'` | Only translates fields that are empty in the target locale               |
+
+## Important Notes
+
+### Explicit `localized: true` for nested fields
+
+Payload CMS allows wrapper fields (group, array, blocks, tabs) to be marked as `localized`, which makes nested fields inherit localization without explicit declaration. However, the plugin only translates **leaf fields** (primitive data fields like text, textarea, richText).
+
+For correct plugin operation, you must explicitly set `localized: true` on each nested field you want to translate:
+
+```typescript
+// ❌ Won't work — nested title is not explicitly localized
+{
+  name: 'meta',
+  type: 'group',
+  localized: true,
+  fields: [
+    { name: 'title', type: 'text' }
+  ]
+}
+
+// ✅ Correct — title is explicitly localized
+{
+  name: 'meta',
+  type: 'group',
+  localized: true,
+  fields: [
+    { name: 'title', type: 'text', localized: true }
+  ]
+}
+```
+
+### Excluded fields behavior
+
+Using `withFieldTranslation({ ... }, { exclude: true })` does not mean the field will be completely untouched during translation. If the excluded field is empty in the target locale, it will be populated with data from the source locale.
+
+This prevents validation errors when saving translation results (e.g., required fields that should not be translated but must have a value).
+
+### Field exclusion priority over strategy
+
+`withFieldTranslation` exclusion takes priority over the `overwrite` strategy. Even when using `overwrite` strategy, excluded fields will:
+
+- Keep their target value if it exists
+- Copy source value only if target is empty
+- Never be sent to the translation provider
+
+### Preserving completed job status
+
+By default, Payload deletes jobs immediately after completion. This means the "Completed" status won't be visible in the UI. To preserve completed jobs and show their status, add this to your Payload config:
+
+```typescript
+export default buildConfig({
+  // ... other config
+  jobs: {
+    deleteJobOnComplete: false,
+  },
+})
+```
+
+## Task Runners
+
+### PayloadJobsRunner (Recommended)
+
+Uses Payload's built-in job queue for background processing:
+
+```typescript
+import { createPayloadJobsRunner } from '@focus-reactive/payload-plugin-translator'
+
+const runner = createPayloadJobsRunner({
+  taskName: 'translate_document',
+  queueName: 'translations',
+  autoRun: {
+    cron: '* * * * *',
+    limit: 50,
+  },
+})
+```
+
+### SyncRunner
+
+Executes translations synchronously (useful for development or small datasets):
+
+```typescript
+import { createSyncRunner } from '@focus-reactive/payload-plugin-translator'
+
+const runner = createSyncRunner()
+```
+
+## Translation Providers
+
+### OpenAI Provider
+
+Built-in provider using OpenAI's API:
+
+```typescript
+import { createOpenAIProvider } from '@focus-reactive/payload-plugin-translator'
+
+const provider = createOpenAIProvider({
+  apiKey: process.env.OPENAI_API_KEY,
+  model: 'gpt-4o-mini',
+  systemPrompt: ({ defaultPrompt }) => `${defaultPrompt}\nUse formal language.`,
+})
+```
+
+### Custom Provider
+
+Create your own translation provider by implementing the `TranslationProvider` interface:
+
+#### TranslationProvider Interface
+
+| Method      | Signature                                                                                       | Description |
+| ----------- | ----------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------- |
+| `translate` | `(content: TranslationInput, sourceLng: string, targetLng: string) => Promise<TranslationOutput | null>`      | Translates content from source to target language |
+
+**Important:** The numeric indices in `TranslationInput` must be preserved exactly in `TranslationOutput`. Each index maps to a specific field in the document structure, so the provider must return the same keys with translated values.
+
+#### Types
+
+```typescript
+// Numeric index representing position in document structure
+type TranslationIndex = number
+
+// Input: Map of numeric indices to text strings
+type TranslationInput = Record<TranslationIndex, string>
+
+// Output: Same indices with translated values
+type TranslationOutput = Record<TranslationIndex, string>
+```
+
+#### Example Implementation
+
+```typescript
+import type {
+  TranslationProvider,
+  TranslationInput,
+  TranslationOutput,
+} from '@focus-reactive/payload-plugin-translator'
+
+class DeepLProvider implements TranslationProvider {
+  constructor(private apiKey: string) {}
+
+  async translate(content: TranslationInput, sourceLng: string, targetLng: string): Promise<TranslationOutput | null> {
+    try {
+      // content example: { "0": "Hello", "1": "World" }
+      const texts = Object.values(content)
+
+      const response = await fetch('https://api.deepl.com/v2/translate', {
+        method: 'POST',
+        headers: {
+          Authorization: `DeepL-Auth-Key ${this.apiKey}`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          text: texts,
+          source_lang: sourceLng.toUpperCase(),
+          target_lang: targetLng.toUpperCase(),
+        }),
+      })
+
+      const data = await response.json()
+
+      // Reconstruct the result with same keys
+      const result: TranslationOutput = {}
+      Object.keys(content).forEach((key, index) => {
+        result[key] = data.translations[index].text
+      })
+
+      return result
+    } catch {
+      return null
+    }
+  }
+}
+
+// Usage
+translatorPlugin({
+  collections: [Posts],
+  translationProvider: new DeepLProvider(process.env.DEEPL_API_KEY),
+  runner: createPayloadJobsRunner(),
+})
+```
+
+## UI Components
+
+The plugin automatically adds:
+
+1. **Document Translation Panel** — Available in the document edit view sidebar
+2. **Bulk Translation Dashboard** — Accessible from collection list view
+3. **Translation Progress Indicator** — Shows real-time translation status
+
+## TypeScript
+
+All types are exported for TypeScript users:
+
+```typescript
+import type {
+  // Plugin config
+  TranslatorPluginConfig,
+
+  // Provider types
+  TranslationProvider,
+  TranslationInput,
+  TranslationOutput,
+  OpenAIProviderConfig,
+  DryRunConfig,
+
+  // Runner types
+  TaskRunnerProvider,
+  PayloadJobsRunnerOptions,
+
+  // Strategy types
+  TranslationStrategy,
+
+  // Access control
+  AccessGuard,
+  AccessGuardRequest,
+
+  // Field config
+  FieldTranslationConfig,
+} from '@focus-reactive/payload-plugin-translator'
+```
+
+## Known Issues
+
+### SQLite: Nested JSON queries not supported
+
+SQLite adapter doesn't support nested JSON field queries like `{ 'input.collection.value': { equals: '5' } }`.
+
+**Affected databases:** SQLite only
+
+## Roadmap
+
+Planned features for future releases:
+
+- **Field-level translation** — Granular translation control allowing users to translate individual fields rather than entire documents
+- **Global translation dashboard** — Translate all collections at once from a single interface, with progress tracking across the entire CMS
+- **Vercel Cron Jobs runner** — Built-in runner for seamless Vercel/serverless deployments without manual API route configuration
+- Auto-translate on source change — Automatically trigger translation when the default locale content is updated

package/dist/client/app/cache/CacheProvider.d.ts

@@ -0,0 +1,7 @@
+import type { PropsWithChildren } from 'react';
+type CacheProviderProps = PropsWithChildren<{
+    basePath?: string;
+}>;
+export declare function CacheProvider({ basePath, children }: CacheProviderProps): import("react").JSX.Element;
+export default CacheProvider;
+//# sourceMappingURL=CacheProvider.d.ts.map

package/dist/client/app/cache/CacheProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheProvider.d.ts","sourceRoot":"","sources":["../../../../src/client/app/cache/CacheProvider.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAM9C,KAAK,kBAAkB,GAAG,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAC,CAAA;AAEF,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,kBAAkB,+BAMvE;AAED,eAAe,aAAa,CAAA"}

package/dist/client/app/cache/CacheProvider.export.d.ts

@@ -0,0 +1,9 @@
+import type { RawPayloadComponentExport } from '../../shared/types/PayloadComponentExport';
+export declare class CacheProviderExport implements RawPayloadComponentExport {
+    path: string;
+    serverProps?: {
+        basePath: string;
+    };
+    constructor(basePath: string);
+}
+//# sourceMappingURL=CacheProvider.export.d.ts.map

package/dist/client/app/cache/CacheProvider.export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheProvider.export.d.ts","sourceRoot":"","sources":["../../../../src/client/app/cache/CacheProvider.export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAA;AAG1F,qBAAa,mBAAoB,YAAW,yBAAyB;IACnE,IAAI,SAAqD;IACzD,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEtB,QAAQ,EAAE,MAAM;CAG7B"}

package/dist/client/app/cache/CacheProvider.export.js

@@ -0,0 +1,12 @@
+import { clientComponentPath } from '../../shared/utils/componentPath';
+export class CacheProviderExport {
+    path = clientComponentPath('app/cache/CacheProvider.tsx');
+    serverProps;
+    constructor(basePath){
+        this.serverProps = {
+            basePath
+        };
+    }
+}
+
+//# sourceMappingURL=CacheProvider.export.js.map

package/dist/client/app/cache/CacheProvider.export.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/app/cache/CacheProvider.export.ts"],"sourcesContent":["import type { RawPayloadComponentExport } from '../../shared/types/PayloadComponentExport'\nimport { clientComponentPath } from '../../shared/utils/componentPath'\n\nexport class CacheProviderExport implements RawPayloadComponentExport {\n  path = clientComponentPath('app/cache/CacheProvider.tsx')\n  serverProps?: { basePath: string }\n\n  constructor(basePath: string) {\n    this.serverProps = { basePath }\n  }\n}\n"],"names":["clientComponentPath","CacheProviderExport","path","serverProps","basePath"],"mappings":"AACA,SAASA,mBAAmB,QAAQ,mCAAkC;AAEtE,OAAO,MAAMC;IACXC,OAAOF,oBAAoB,+BAA8B;IACzDG,YAAkC;IAElC,YAAYC,QAAgB,CAAE;QAC5B,IAAI,CAACD,WAAW,GAAG;YAAEC;QAAS;IAChC;AACF"}

package/dist/client/app/cache/CacheProvider.js

@@ -0,0 +1,18 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { QueryClientProvider } from '@tanstack/react-query';
+import { CacheClientProviderFactory } from '../../shared/providers/CacheClientProvider';
+import { TranslateKitConfigProvider } from '../config';
+const queryClient = new CacheClientProviderFactory().create('client');
+export function CacheProvider({ basePath, children }) {
+    return /*#__PURE__*/ _jsx(TranslateKitConfigProvider, {
+        basePath: basePath,
+        children: /*#__PURE__*/ _jsx(QueryClientProvider, {
+            client: queryClient,
+            children: children
+        })
+    });
+}
+export default CacheProvider;
+
+//# sourceMappingURL=CacheProvider.js.map

package/dist/client/app/cache/CacheProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/app/cache/CacheProvider.tsx"],"sourcesContent":["'use client'\n\nimport { QueryClientProvider } from '@tanstack/react-query'\nimport type { PropsWithChildren } from 'react'\nimport { CacheClientProviderFactory } from '../../shared/providers/CacheClientProvider'\nimport { TranslateKitConfigProvider } from '../config'\n\nconst queryClient = new CacheClientProviderFactory().create('client')\n\ntype CacheProviderProps = PropsWithChildren<{\n  basePath?: string\n}>\n\nexport function CacheProvider({ basePath, children }: CacheProviderProps) {\n  return (\n    <TranslateKitConfigProvider basePath={basePath}>\n      <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>\n    </TranslateKitConfigProvider>\n  )\n}\n\nexport default CacheProvider\n"],"names":["QueryClientProvider","CacheClientProviderFactory","TranslateKitConfigProvider","queryClient","create","CacheProvider","basePath","children","client"],"mappings":"AAAA;;AAEA,SAASA,mBAAmB,QAAQ,wBAAuB;AAE3D,SAASC,0BAA0B,QAAQ,6CAA4C;AACvF,SAASC,0BAA0B,QAAQ,YAAW;AAEtD,MAAMC,cAAc,IAAIF,6BAA6BG,MAAM,CAAC;AAM5D,OAAO,SAASC,cAAc,EAAEC,QAAQ,EAAEC,QAAQ,EAAsB;IACtE,qBACE,KAACL;QAA2BI,UAAUA;kBACpC,cAAA,KAACN;YAAoBQ,QAAQL;sBAAcI;;;AAGjD;AAEA,eAAeF,cAAa"}

package/dist/client/app/cache/CacheProvider.jsx

@@ -0,0 +1,11 @@
+'use client';
+import { QueryClientProvider } from '@tanstack/react-query';
+import { CacheClientProviderFactory } from '../../shared/providers/CacheClientProvider';
+import { TranslateKitConfigProvider } from '../config';
+const queryClient = new CacheClientProviderFactory().create('client');
+export function CacheProvider({ basePath, children }) {
+    return (<TranslateKitConfigProvider basePath={basePath}>
+      <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+    </TranslateKitConfigProvider>);
+}
+export default CacheProvider;

package/dist/client/app/config/TranslateKitConfigContext.d.ts

@@ -0,0 +1,9 @@
+import { type PropsWithChildren } from 'react';
+type TranslateKitConfig = {
+    basePath: string;
+};
+export type TranslateKitConfigProviderProps = PropsWithChildren<Partial<TranslateKitConfig>>;
+export declare function TranslateKitConfigProvider({ basePath, children, }: TranslateKitConfigProviderProps): import("react").JSX.Element;
+export declare function useTranslateKitConfig(): TranslateKitConfig;
+export {};
+//# sourceMappingURL=TranslateKitConfigContext.d.ts.map

package/dist/client/app/config/TranslateKitConfigContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslateKitConfigContext.d.ts","sourceRoot":"","sources":["../../../../src/client/app/config/TranslateKitConfigContext.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAsC,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAElF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAQD,MAAM,MAAM,+BAA+B,GAAG,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAA;AAE5F,wBAAgB,0BAA0B,CAAC,EACzC,QAAiC,EACjC,QAAQ,GACT,EAAE,+BAA+B,+BAIjC;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D"}

package/dist/client/app/config/TranslateKitConfigContext.js

@@ -0,0 +1,23 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from 'react';
+const defaultConfig = {
+    basePath: '/translate'
+};
+const TranslateKitConfigContext = /*#__PURE__*/ createContext(defaultConfig);
+export function TranslateKitConfigProvider({ basePath = defaultConfig.basePath, children }) {
+    const value = useMemo(()=>({
+            basePath
+        }), [
+        basePath
+    ]);
+    return /*#__PURE__*/ _jsx(TranslateKitConfigContext.Provider, {
+        value: value,
+        children: children
+    });
+}
+export function useTranslateKitConfig() {
+    return useContext(TranslateKitConfigContext);
+}
+
+//# sourceMappingURL=TranslateKitConfigContext.js.map

package/dist/client/app/config/TranslateKitConfigContext.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/app/config/TranslateKitConfigContext.tsx"],"sourcesContent":["'use client'\n\nimport { createContext, useContext, useMemo, type PropsWithChildren } from 'react'\n\ntype TranslateKitConfig = {\n  basePath: string\n}\n\nconst defaultConfig: TranslateKitConfig = {\n  basePath: '/translate',\n}\n\nconst TranslateKitConfigContext = createContext<TranslateKitConfig>(defaultConfig)\n\nexport type TranslateKitConfigProviderProps = PropsWithChildren<Partial<TranslateKitConfig>>\n\nexport function TranslateKitConfigProvider({\n  basePath = defaultConfig.basePath,\n  children,\n}: TranslateKitConfigProviderProps) {\n  const value = useMemo(() => ({ basePath }), [basePath])\n\n  return <TranslateKitConfigContext.Provider value={value}>{children}</TranslateKitConfigContext.Provider>\n}\n\nexport function useTranslateKitConfig(): TranslateKitConfig {\n  return useContext(TranslateKitConfigContext)\n}\n"],"names":["createContext","useContext","useMemo","defaultConfig","basePath","TranslateKitConfigContext","TranslateKitConfigProvider","children","value","Provider","useTranslateKitConfig"],"mappings":"AAAA;;AAEA,SAASA,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAAgC,QAAO;AAMlF,MAAMC,gBAAoC;IACxCC,UAAU;AACZ;AAEA,MAAMC,0CAA4BL,cAAkCG;AAIpE,OAAO,SAASG,2BAA2B,EACzCF,WAAWD,cAAcC,QAAQ,EACjCG,QAAQ,EACwB;IAChC,MAAMC,QAAQN,QAAQ,IAAO,CAAA;YAAEE;QAAS,CAAA,GAAI;QAACA;KAAS;IAEtD,qBAAO,KAACC,0BAA0BI,QAAQ;QAACD,OAAOA;kBAAQD;;AAC5D;AAEA,OAAO,SAASG;IACd,OAAOT,WAAWI;AACpB"}

package/dist/client/app/config/TranslateKitConfigContext.jsx

@@ -0,0 +1,13 @@
+'use client';
+import { createContext, useContext, useMemo } from 'react';
+const defaultConfig = {
+    basePath: '/translate',
+};
+const TranslateKitConfigContext = createContext(defaultConfig);
+export function TranslateKitConfigProvider({ basePath = defaultConfig.basePath, children, }) {
+    const value = useMemo(() => ({ basePath }), [basePath]);
+    return <TranslateKitConfigContext.Provider value={value}>{children}</TranslateKitConfigContext.Provider>;
+}
+export function useTranslateKitConfig() {
+    return useContext(TranslateKitConfigContext);
+}

package/dist/client/app/config/index.d.ts

@@ -0,0 +1,3 @@
+export { TranslateKitConfigProvider, useTranslateKitConfig } from './TranslateKitConfigContext';
+export type { TranslateKitConfigProviderProps } from './TranslateKitConfigContext';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/app/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/app/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAC/F,YAAY,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/client/app/config/index.js

@@ -0,0 +1,3 @@
+export { TranslateKitConfigProvider, useTranslateKitConfig } from './TranslateKitConfigContext';
+
+//# sourceMappingURL=index.js.map

package/dist/client/app/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/app/config/index.ts"],"sourcesContent":["export { TranslateKitConfigProvider, useTranslateKitConfig } from './TranslateKitConfigContext'\nexport type { TranslateKitConfigProviderProps } from './TranslateKitConfigContext'\n"],"names":["TranslateKitConfigProvider","useTranslateKitConfig"],"mappings":"AAAA,SAASA,0BAA0B,EAAEC,qBAAqB,QAAQ,8BAA6B"}

package/dist/client/entities/translation/api/mutations/useCancelCollectionTranslations.d.ts

@@ -0,0 +1,6 @@
+type Variables = {
+    collection: string;
+};
+export declare function useCancelCollectionTranslations(): import("@tanstack/react-query").UseMutationResult<void, Error, Variables, unknown>;
+export {};
+//# sourceMappingURL=useCancelCollectionTranslations.d.ts.map

package/dist/client/entities/translation/api/mutations/useCancelCollectionTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCancelCollectionTranslations.d.ts","sourceRoot":"","sources":["../../../../../../src/client/entities/translation/api/mutations/useCancelCollectionTranslations.ts"],"names":[],"mappings":"AAMA,KAAK,SAAS,GAAG;IACf,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,+BAA+B,uFAiB9C"}

package/dist/client/entities/translation/api/mutations/useCancelCollectionTranslations.js

@@ -0,0 +1,27 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { ofetch } from 'ofetch';
+import { useTranslateKitConfig } from '../../../../app/config';
+import { handleNextApiError } from '../../../../shared/lib/errors/handleApiError';
+export function useCancelCollectionTranslations() {
+    const queryClient = useQueryClient();
+    const { basePath } = useTranslateKitConfig();
+    return useMutation({
+        mutationKey: [
+            'cancel-collection-translations'
+        ],
+        mutationFn: async (variables)=>{
+            await handleNextApiError(()=>ofetch(`/api${basePath}/cancel-by-collection/${variables.collection}`, {
+                    method: 'delete'
+                }));
+        },
+        onSuccess: ()=>{
+            queryClient.invalidateQueries({
+                queryKey: [
+                    'collection-translation-status'
+                ]
+            });
+        }
+    });
+}
+
+//# sourceMappingURL=useCancelCollectionTranslations.js.map

package/dist/client/entities/translation/api/mutations/useCancelCollectionTranslations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/client/entities/translation/api/mutations/useCancelCollectionTranslations.ts"],"sourcesContent":["import { useMutation, useQueryClient } from '@tanstack/react-query'\nimport { ofetch } from 'ofetch'\n\nimport { useTranslateKitConfig } from '../../../../app/config'\nimport { handleNextApiError } from '../../../../shared/lib/errors/handleApiError'\n\ntype Variables = {\n  collection: string\n}\n\nexport function useCancelCollectionTranslations() {\n  const queryClient = useQueryClient()\n  const { basePath } = useTranslateKitConfig()\n\n  return useMutation({\n    mutationKey: ['cancel-collection-translations'],\n    mutationFn: async (variables: Variables): Promise<void> => {\n      await handleNextApiError(() =>\n        ofetch(`/api${basePath}/cancel-by-collection/${variables.collection}`, {\n          method: 'delete',\n        }),\n      )\n    },\n    onSuccess: () => {\n      queryClient.invalidateQueries({ queryKey: ['collection-translation-status'] })\n    },\n  })\n}\n"],"names":["useMutation","useQueryClient","ofetch","useTranslateKitConfig","handleNextApiError","useCancelCollectionTranslations","queryClient","basePath","mutationKey","mutationFn","variables","collection","method","onSuccess","invalidateQueries","queryKey"],"mappings":"AAAA,SAASA,WAAW,EAAEC,cAAc,QAAQ,wBAAuB;AACnE,SAASC,MAAM,QAAQ,SAAQ;AAE/B,SAASC,qBAAqB,QAAQ,yBAAwB;AAC9D,SAASC,kBAAkB,QAAQ,+CAA8C;AAMjF,OAAO,SAASC;IACd,MAAMC,cAAcL;IACpB,MAAM,EAAEM,QAAQ,EAAE,GAAGJ;IAErB,OAAOH,YAAY;QACjBQ,aAAa;YAAC;SAAiC;QAC/CC,YAAY,OAAOC;YACjB,MAAMN,mBAAmB,IACvBF,OAAO,CAAC,IAAI,EAAEK,SAAS,sBAAsB,EAAEG,UAAUC,UAAU,EAAE,EAAE;oBACrEC,QAAQ;gBACV;QAEJ;QACAC,WAAW;YACTP,YAAYQ,iBAAiB,CAAC;gBAAEC,UAAU;oBAAC;iBAAgC;YAAC;QAC9E;IACF;AACF"}

package/dist/client/entities/translation/api/mutations/useCancelDocumentTranslation.d.ts

@@ -0,0 +1,6 @@
+type Variables = {
+    id: string;
+};
+export declare function useCancelDocumentTranslation(): import("@tanstack/react-query").UseMutationResult<void, Error, Variables, unknown>;
+export {};
+//# sourceMappingURL=useCancelDocumentTranslation.d.ts.map

package/dist/client/entities/translation/api/mutations/useCancelDocumentTranslation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCancelDocumentTranslation.d.ts","sourceRoot":"","sources":["../../../../../../src/client/entities/translation/api/mutations/useCancelDocumentTranslation.ts"],"names":[],"mappings":"AAMA,KAAK,SAAS,GAAG;IACf,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,wBAAgB,4BAA4B,uFAkB3C"}