@focus-reactive/payload-plugin-translator 0.6.1 → 0.7.0

package/dist/server/shared/index.d.ts

@@ -3,9 +3,10 @@ export { AnyAccessGuard } from "./access";
 export type { AccessGuard, AccessGuardRequest, Handler } from "./access";
 export { isEmpty, isObject, normalizePath, pipe, getByPath, setByPath, filterLocalizedFields, } from "./utils";
 export type { TranslatableField } from "./guards";
-export { isTranslatableField, isLocalizedField, isRelationshipField, isTabsField, isBlockItem, hasFields, } from "./guards";
-export { isFieldExcludedFromTranslation, getTranslateKitFieldConfig, } from "./field-config";
-export type { TranslateKitFieldConfig } from "./field-config";
-export { isSerializedLexicalRoot, isEmptyRichText, traverseLexicalTree, collectSerializedLexicalTextNodes, } from "./lexical";
-export type { SerializedTextNodeRef } from "./lexical";
+export { isTranslatableField, isLocalizedField, isRelationshipField } from "./guards";
+export { isTabsField, isBlockItem, hasFields } from "../../core/field-traversal";
+export { isFieldExcludedFromTranslation, getTranslateKitFieldConfig, } from "../../core/field-config";
+export type { TranslateKitFieldConfig } from "../../core/field-config";
+export { isSerializedLexicalRoot, isEmptyRichText, traverseLexicalTree, collectSerializedLexicalTextNodes, } from "../../core/lexical";
+export type { SerializedTextNodeRef } from "../../core/lexical";
 export { JobIdSchema } from "./validation";

package/dist/server/shared/index.js

@@ -4,11 +4,12 @@ export { ServerResponse, withErrorHandler, withAccessCheck } from "./http";
 export { AnyAccessGuard } from "./access";
 // General utilities
 export { isEmpty, isObject, normalizePath, pipe, getByPath, setByPath, filterLocalizedFields } from "./utils";
-export { isTranslatableField, isLocalizedField, isRelationshipField, isTabsField, isBlockItem, hasFields } from "./guards";
+export { isTranslatableField, isLocalizedField, isRelationshipField } from "./guards";
+export { isTabsField, isBlockItem, hasFields } from "../../core/field-traversal";
 // Field config
-export { isFieldExcludedFromTranslation, getTranslateKitFieldConfig } from "./field-config";
+export { isFieldExcludedFromTranslation, getTranslateKitFieldConfig } from "../../core/field-config";
 // Lexical utilities
-export { isSerializedLexicalRoot, isEmptyRichText, traverseLexicalTree, collectSerializedLexicalTextNodes } from "./lexical";
+export { isSerializedLexicalRoot, isEmptyRichText, traverseLexicalTree, collectSerializedLexicalTextNodes } from "../../core/lexical";
 // Validation primitives
 export { JobIdSchema } from "./validation";
 

package/dist/server/shared/utils/filterLocalizedFields.js

@@ -1,6 +1,6 @@
-import { resolveBlockFields, walkFields } from "../field-traversal";
+import { resolveBlockFields, walkFields } from "../../../core/field-traversal";
 import { isLocalizedField, isTranslatableField } from "../guards";
-import { isObject } from "./isObject";
+import { isObject } from "../../../core/utils/isObject";
 /**
  * Filter walker: keeps only translatable, localized leaves, rebuilding the surrounding
  * object/array/blocks structure and dropping any container left empty. `id` (array/block

package/dist/server/shared/utils/getByPath.js

@@ -1,4 +1,4 @@
-import { isObject } from './isObject';
+import { isObject } from "../../../core/utils/isObject";
 /**
  * Gets a value from an object by dot-notation path.
  *
@@ -6,7 +6,7 @@ import { isObject } from './isObject';
  * getByPath({ a: { b: 1 } }, 'a.b') // 1
  * getByPath({ arr: [{ x: 1 }] }, 'arr.0.x') // 1
  */ export function getByPath(obj, path) {
-    const keys = path.split('.');
+    const keys = path.split(".");
     let current = obj;
     for (const key of keys){
         if (!isObject(current)) return undefined;

package/dist/server/shared/utils/index.d.ts

@@ -1,9 +1,9 @@
-export { isEmpty } from './isEmpty';
-export { isObject } from './isObject';
-export { normalizePath } from './normalizePath';
-export { getByPath } from './getByPath';
-export { setByPath } from './setByPath';
-export { pipe } from './pipe';
-export { filterLocalizedFields } from './filterLocalizedFields';
-export { LazyMap } from './LazyMap';
-export type { LazyMapOptions } from './LazyMap';
+export { isEmpty } from "../../../core/utils/isEmpty";
+export { isObject } from "../../../core/utils/isObject";
+export { normalizePath } from "./normalizePath";
+export { getByPath } from "./getByPath";
+export { setByPath } from "./setByPath";
+export { pipe } from "./pipe";
+export { filterLocalizedFields } from "./filterLocalizedFields";
+export { LazyMap } from "./LazyMap";
+export type { LazyMapOptions } from "./LazyMap";

package/dist/server/shared/utils/index.js

@@ -1,10 +1,10 @@
-export { isEmpty } from './isEmpty';
-export { isObject } from './isObject';
-export { normalizePath } from './normalizePath';
-export { getByPath } from './getByPath';
-export { setByPath } from './setByPath';
-export { pipe } from './pipe';
-export { filterLocalizedFields } from './filterLocalizedFields';
-export { LazyMap } from './LazyMap';
+export { isEmpty } from "../../../core/utils/isEmpty";
+export { isObject } from "../../../core/utils/isObject";
+export { normalizePath } from "./normalizePath";
+export { getByPath } from "./getByPath";
+export { setByPath } from "./setByPath";
+export { pipe } from "./pipe";
+export { filterLocalizedFields } from "./filterLocalizedFields";
+export { LazyMap } from "./LazyMap";
 
 //# sourceMappingURL=index.js.map

package/dist/server/shared/utils/normalizePath.js

@@ -13,10 +13,10 @@
  * normalizePath('  ')             // ''
  */ export function normalizePath(path) {
     const trimmed = path.trim();
-    if (!trimmed) return '';
+    if (!trimmed) return "";
     // Remove leading/trailing slashes, then add single leading slash
-    const normalized = trimmed.replace(/^\/+|\/+$/g, '');
-    return normalized ? `/${normalized}` : '';
+    const normalized = trimmed.replace(/^\/+|\/+$/g, "");
+    return normalized ? `/${normalized}` : "";
 }
 
 //# sourceMappingURL=normalizePath.js.map

package/dist/server/shared/utils/setByPath.js

@@ -1,4 +1,4 @@
-import { isObject } from './isObject';
+import { isObject } from "../../../core/utils/isObject";
 /**
  * Sets a value in an object by dot-notation path.
  * Creates intermediate objects/arrays as needed.
@@ -8,7 +8,7 @@ import { isObject } from './isObject';
  * setByPath(obj, 'a.b', 1) // { a: { b: 1 } }
  * setByPath(obj, 'arr.0.x', 1) // { arr: [{ x: 1 }] }
  */ export function setByPath(obj, path, value) {
-    const keys = path.split('.');
+    const keys = path.split(".");
     let current = obj;
     for(let i = 0; i < keys.length - 1; i++){
         const key = keys[i];

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

@@ -0,0 +1,2 @@
+export type { TranslationProvider, TranslationInput, TranslationOutput, } from "../core/translation-providers";
+export * from "./openai";

package/dist/translation-providers/index.js

@@ -0,0 +1,10 @@
+// Translation-provider implementations (adapters), one directory per vendor. Payload-free and
+// opt-in — each vendor pulls its own deps (e.g. `openai`). Kept OUT of the framework-agnostic core
+// so the core stays dependency-free; the PORT they implement lives in the core and is re-exported
+// here for convenience. Naming is explicit ("translation-providers") to leave room for other kinds
+// of providers later without a collision.
+// The port (contract) — source of truth is the core.
+// Vendor implementations.
+export * from "./openai";
+
+//# sourceMappingURL=index.js.map

package/dist/{server/modules/translation-providers → translation-providers/openai}/OpenAITranslation.provider.d.ts

@@ -1,4 +1,4 @@
-import type { TranslationProvider, TranslationInput, TranslationOutput } from "./TranslationProvider.interface";
+import type { TranslationProvider, TranslationInput, TranslationOutput } from "../../core/translation-providers/TranslationProvider.interface";
 import type { ChatModel } from "openai/resources/index.mjs";
 /**
  * Function to transform text in dry run mode.

package/dist/{server/modules/translation-providers → translation-providers/openai}/OpenAITranslation.provider.js

@@ -1,5 +1,5 @@
 import OpenAI from "openai";
-import { isObject } from "../../shared";
+import { isObject } from "../../core/utils/isObject";
 /** @deprecated Use `createOpenAIProvider` function instead */ export class OpenAITranslationProvider {
     openAiClient;
     config;

package/dist/translation-providers/openai/index.d.ts

@@ -0,0 +1 @@
+export { OpenAITranslationProvider, createOpenAIProvider, type OpenAIProviderConfig, type DryRunConfig, type SystemPromptContext, } from "./OpenAITranslation.provider";

package/dist/translation-providers/openai/index.js

@@ -0,0 +1,5 @@
+// OpenAI translation provider — one vendor implementation of the core `TranslationProvider`
+// port. Payload-free; pulls the `openai` SDK (opt-in).
+export { OpenAITranslationProvider, createOpenAIProvider } from "./OpenAITranslation.provider";
+
+//# sourceMappingURL=index.js.map

package/dist/types/CollectionSchemaMap.d.ts

@@ -0,0 +1,6 @@
+import type { CollectionSlug, Field } from "payload";
+/**
+ * Map of collection slug to original field schema.
+ * Used to access original schemas before Payload sanitization.
+ */
+export type CollectionSchemaMap = Map<CollectionSlug, Field[]>;

package/dist/types/CollectionSchemaMap.js

@@ -0,0 +1,6 @@
+/**
+ * Map of collection slug to original field schema.
+ * Used to access original schemas before Payload sanitization.
+ */ export { };
+
+//# sourceMappingURL=CollectionSchemaMap.js.map

package/dist/{client/shared/types → types}/PayloadComponentExport.d.ts

@@ -1,2 +1,2 @@
-import type { RawPayloadComponent } from 'payload';
+import type { RawPayloadComponent } from "payload";
 export type RawPayloadComponentExport = RawPayloadComponent;

package/dist/types/index.d.ts

@@ -1 +1,4 @@
-export type { AccessGuard, AccessGuardRequest } from './AccessGuard';
+export type { AccessGuard, AccessGuardRequest } from "./AccessGuard";
+export type { CollectionSchemaMap } from "./CollectionSchemaMap";
+export type { RawPayloadComponentExport } from "./PayloadComponentExport";
+export type { FieldTranslationNotice, FieldTranslationResult } from "./wire/field-translation";

package/dist/types/wire/field-translation.d.ts

@@ -0,0 +1,17 @@
+export type FieldTranslationNotice = {
+    level: "info" | "warning";
+    message: string;
+};
+/**
+ * Successful response. Never an error for "couldn't translate": a field with no
+ * localized content (or a path our resolver can't handle yet) is a `noop` with a
+ * calm notice, not an HTTP error.
+ */
+export type FieldTranslationResult = {
+    status: "translated";
+    value: unknown;
+} | {
+    status: "noop";
+    value: unknown;
+    notice: FieldTranslationNotice;
+};

package/dist/types/wire/field-translation.js

@@ -0,0 +1,7 @@
+/**
+ * Successful response. Never an error for "couldn't translate": a field with no
+ * localized content (or a path our resolver can't handle yet) is a `noop` with a
+ * calm notice, not an HTTP error.
+ */ export { };
+
+//# sourceMappingURL=field-translation.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@focus-reactive/payload-plugin-translator",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Translation plugin for Payload CMS 3.x. Automatically translate your localized content using any translation provider.",
   "type": "module",
   "license": "MIT",
@@ -53,6 +53,8 @@
     "dev": "bun run build:swc -- --watch --copy-files",
     "lint": "ultracite check",
     "lint:fix": "ultracite fix",
+    "format": "ultracite fix",
+    "format:check": "ultracite check",
     "test": "vitest run",
     "test:watch": "vitest",
     "check-types": "tsgo --noEmit -p tsconfig.check.json"

package/dist/server/modules/translation-pipeline/stages/data-reconciler/index.d.ts

@@ -1,2 +0,0 @@
-export { DataReconciler } from './DataReconciler';
-export { DataReconcilerStage } from './DataReconciler.stage';

package/dist/server/modules/translation-pipeline/stages/data-reconciler/index.js

@@ -1,4 +0,0 @@
-export { DataReconciler } from './DataReconciler';
-export { DataReconcilerStage } from './DataReconciler.stage';
-
-//# sourceMappingURL=index.js.map

package/dist/server/modules/translation-pipeline/stages/field-collector/index.d.ts

@@ -1,2 +0,0 @@
-export { FieldChunkCollector } from './FieldChunkCollector';
-export { FieldChunkCollectorStage } from './FieldChunkCollector.stage';

package/dist/server/modules/translation-pipeline/stages/field-collector/index.js

@@ -1,4 +0,0 @@
-export { FieldChunkCollector } from './FieldChunkCollector';
-export { FieldChunkCollectorStage } from './FieldChunkCollector.stage';
-
-//# sourceMappingURL=index.js.map

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

@@ -1,6 +0,0 @@
-export { DataReconciler, DataReconcilerStage } from './data-reconciler';
-export { FieldChunkCollector, FieldChunkCollectorStage } from './field-collector';
-export { TextChunkExpander, PlainTextExpander, RichTextExpander, TextChunkExpanderStage } from './text-expander';
-export type { TextExpansionResult, TextExpander, ExpansionResult } from './text-expander';
-export { TranslationStage } from './translation';
-export { TranslationMutator, TranslationMutatorStage } from './translation-applicator';

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

@@ -1,7 +0,0 @@
-export { DataReconciler, DataReconcilerStage } from './data-reconciler';
-export { FieldChunkCollector, FieldChunkCollectorStage } from './field-collector';
-export { TextChunkExpander, PlainTextExpander, RichTextExpander, TextChunkExpanderStage } from './text-expander';
-export { TranslationStage } from './translation';
-export { TranslationMutator, TranslationMutatorStage } from './translation-applicator';
-
-//# sourceMappingURL=index.js.map

package/dist/server/modules/translation-pipeline/stages/text-expander/index.d.ts

@@ -1,6 +0,0 @@
-export { TextChunkExpander } from './TextChunkExpander';
-export type { TextExpansionResult } from './TextChunkExpander';
-export type { TextExpander, ExpansionResult } from './TextExpander.interface';
-export { PlainTextExpander } from './PlainTextExpander';
-export { RichTextExpander } from './RichTextExpander';
-export { TextChunkExpanderStage } from './TextChunkExpander.stage';

package/dist/server/modules/translation-pipeline/stages/text-expander/index.js

@@ -1,6 +0,0 @@
-export { TextChunkExpander } from './TextChunkExpander';
-export { PlainTextExpander } from './PlainTextExpander';
-export { RichTextExpander } from './RichTextExpander';
-export { TextChunkExpanderStage } from './TextChunkExpander.stage';
-
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-export { TranslationStage } from './Translation.stage';

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

@@ -1,3 +0,0 @@
-export { TranslationStage } from './Translation.stage';
-
-//# sourceMappingURL=index.js.map

package/dist/server/modules/translation-pipeline/stages/translation-applicator/index.d.ts

@@ -1,2 +0,0 @@
-export { TranslationMutator } from './TranslationMutator';
-export { TranslationMutatorStage } from './TranslationMutator.stage';

package/dist/server/modules/translation-pipeline/stages/translation-applicator/index.js

@@ -1,4 +0,0 @@
-export { TranslationMutator } from './TranslationMutator';
-export { TranslationMutatorStage } from './TranslationMutator.stage';
-
-//# sourceMappingURL=index.js.map

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

@@ -1,13 +0,0 @@
-import type { TranslationStrategy } from './TranslationStrategy.interface';
-import { OverwriteStrategy } from './Overwrite.strategy';
-import { SkipExistingStrategy } from './SkipExisting.strategy';
-export type { TranslationStrategy, StrategyContext } from './TranslationStrategy.interface';
-export { OverwriteStrategy, SkipExistingStrategy };
-/**
- * Strategy names for runtime selection.
- */
-export type TranslationStrategyName = 'overwrite' | 'skip_existing';
-/**
- * Creates a TranslationStrategy instance by name.
- */
-export declare function createTranslationStrategy(name: TranslationStrategyName): TranslationStrategy;

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

@@ -1,5 +0,0 @@
-export type { FieldChunk } from './FieldChunk';
-export type { PlainTextChunk, RichTextChunk, TextChunk } from './TextChunk';
-export { isPlainTextChunk, isRichTextChunk } from './TextChunk';
-export type { PipelineConfig, PipelineResult } from './Pipeline';
-export type { PipelineContext, PipelineStage } from './PipelineContext';

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

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

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

@@ -1,2 +0,0 @@
-export type { TranslationProvider, TranslationInput, TranslationOutput, TranslationIndex, } from './TranslationProvider.interface';
-export { OpenAITranslationProvider, createOpenAIProvider, type OpenAIProviderConfig, type DryRunConfig, type SystemPromptContext, } from './OpenAITranslation.provider';

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

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

package/dist/server/shared/field-config/getFieldConfig.d.ts

@@ -1,20 +0,0 @@
-import type { Field } from 'payload';
-import type { FieldTranslationConfig } from './types';
-/**
- * Extract translation configuration from a Payload field.
- *
- * @param field - The Payload field to extract config from
- * @returns The translation configuration, or empty object if not defined
- */
-export declare function getFieldTranslationConfig(field: Field): FieldTranslationConfig;
-/**
- * @deprecated Use `getFieldTranslationConfig` instead
- */
-export declare const getTranslateKitFieldConfig: typeof getFieldTranslationConfig;
-/**
- * Check if a field should be excluded from translation.
- *
- * @param field - The Payload field to check
- * @returns true if the field has `translateKit.exclude: true`
- */
-export declare function isFieldExcludedFromTranslation(field: Field): boolean;

package/dist/server/shared/field-config/index.js

@@ -1,4 +0,0 @@
-export { getFieldTranslationConfig, getTranslateKitFieldConfig, isFieldExcludedFromTranslation } from './getFieldConfig';
-export { TRANSLATE_KIT_CUSTOM_KEY } from './types';
-
-//# sourceMappingURL=index.js.map

package/dist/server/shared/field-traversal/index.d.ts

@@ -1,5 +0,0 @@
-export { findFieldByPath } from "./findFieldByPath";
-export type { FieldPathResult } from "./findFieldByPath";
-export { classifyField, matchElementById, resolveBlockFields, tabScopes } from "./kernel";
-export type { ChildCursor, ChildOutput, ContainerInfo, FieldStructure, FieldWalker, LeafField, TabScope, WalkSignal } from "./types";
-export { walkFields } from "./walkFields";

package/dist/server/shared/field-traversal/index.js

@@ -1,5 +0,0 @@
-export { findFieldByPath } from "./findFieldByPath";
-export { classifyField, matchElementById, resolveBlockFields, tabScopes } from "./kernel";
-export { walkFields } from "./walkFields";
-
-//# sourceMappingURL=index.js.map

package/dist/server/shared/lexical/index.d.ts

@@ -1,6 +0,0 @@
-export type { SerializedTextNodeRef, SerializedLexicalRoot, SerializedLexicalNode, SerializedTextNode, SerializedRootNode, } from './types';
-export type { SerializedLexicalNodeWithChildren } from './guards';
-export { isSerializedLexicalRoot, isSerializedLexicalTextNode, hasChildren } from './guards';
-export { isEmptyRichText } from './isEmptyRichText';
-export { traverseLexicalTree } from './traverseLexicalTree';
-export { collectSerializedLexicalTextNodes } from './collectTextNodes';

package/dist/server/shared/lexical/index.js

@@ -1,6 +0,0 @@
-export { isSerializedLexicalRoot, isSerializedLexicalTextNode, hasChildren } from './guards';
-export { isEmptyRichText } from './isEmptyRichText';
-export { traverseLexicalTree } from './traverseLexicalTree';
-export { collectSerializedLexicalTextNodes } from './collectTextNodes';
-
-//# sourceMappingURL=index.js.map

package/dist/server/shared/lexical/types.d.ts

@@ -1,19 +0,0 @@
-/**
- * Re-exports serialized Lexical types from 'lexical' package.
- * These types represent the JSON structure stored in the database.
- */
-import type { SerializedLexicalNode, SerializedTextNode, SerializedRootNode } from '@payloadcms/richtext-lexical/lexical';
-export type { SerializedLexicalNode, SerializedTextNode, SerializedRootNode };
-/**
- * Serialized Lexical root structure as stored in Payload CMS richText fields.
- * Wraps the root node in a { root: ... } object.
- */
-export type SerializedLexicalRoot = {
-    root: SerializedLexicalNode;
-};
-/**
- * Reference to a serialized text node for mutation during translation.
- */
-export type SerializedTextNodeRef = {
-    node: SerializedTextNode;
-};

package/dist/server/shared/lexical/types.js

@@ -1,8 +0,0 @@
-/**
- * Re-exports serialized Lexical types from 'lexical' package.
- * These types represent the JSON structure stored in the database.
- */ /**
- * Reference to a serialized text node for mutation during translation.
- */ export { };
-
-//# sourceMappingURL=types.js.map