@focus-reactive/payload-plugin-translator 0.10.4 → 0.11.1

package/dist/translation-providers/shared/errors/index.js

@@ -0,0 +1,10 @@
+export { TranslationProviderError } from "./TranslationProviderError";
+export { NoContentError } from "./NoContentError";
+export { UnparseableReplyError } from "./UnparseableReplyError";
+export { KeySetMismatchError } from "./KeySetMismatchError";
+export { TransportError } from "./TransportError";
+export { ProviderConfigurationError } from "./ProviderConfigurationError";
+export { wrapTransportError } from "./wrapTransportError";
+export { errorMessageLower } from "./errorMessageLower";
+
+//# sourceMappingURL=index.js.map

package/dist/translation-providers/shared/errors/wrapTransportError.d.ts

@@ -0,0 +1,7 @@
+import { TranslationProviderError } from "./TranslationProviderError";
+/**
+ * Turns anything a transport threw into a {@link TransportError}, keeping the original on `cause`.
+ * A value that is already one of ours passes through: re-wrapping would bury a specific cause under
+ * a generic transport failure.
+ */
+export declare function wrapTransportError(cause: unknown): TranslationProviderError;

package/dist/translation-providers/shared/errors/wrapTransportError.js

@@ -0,0 +1,14 @@
+import { TransportError } from "./TransportError";
+import { TranslationProviderError } from "./TranslationProviderError";
+/**
+ * Turns anything a transport threw into a {@link TransportError}, keeping the original on `cause`.
+ * A value that is already one of ours passes through: re-wrapping would bury a specific cause under
+ * a generic transport failure.
+ */ export function wrapTransportError(cause) {
+    if (cause instanceof TranslationProviderError) return cause;
+    return new TransportError("The translation request failed before a reply could be read. The provider's own error is on this error's `cause` property.", {
+        cause
+    });
+}
+
+//# sourceMappingURL=wrapTransportError.js.map

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

@@ -0,0 +1,8 @@
+export { createTranslationProvider } from "./CompletionProvider.provider";
+export type { CompletionFn, CompletionRequest, TranslationProviderConfig, } from "./CompletionProvider.provider";
+export type { JsonSchemaObject } from "./buildResponseSchema";
+export type { SystemPromptBuilder, SystemPromptContext } from "./buildSystemPrompt";
+export type { DryRunConfig, DryRunTransformer } from "./runDryRun";
+export { errorMessageLower } from "./errors";
+export { TranslationProviderError, NoContentError, UnparseableReplyError, KeySetMismatchError, TransportError, ProviderConfigurationError, } from "./errors";
+export type { TranslationFailureCode } from "./errors";

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

@@ -0,0 +1,5 @@
+export { createTranslationProvider } from "./CompletionProvider.provider";
+export { errorMessageLower } from "./errors";
+export { TranslationProviderError, NoContentError, UnparseableReplyError, KeySetMismatchError, TransportError, ProviderConfigurationError } from "./errors";
+
+//# sourceMappingURL=index.js.map

package/dist/translation-providers/shared/parseAndValidateReply.d.ts

@@ -0,0 +1,13 @@
+import type { TranslationInput, TranslationOutput } from "../../core/domain/translation-providers";
+export type ParsedReply = {
+    translations: TranslationOutput;
+    missingInputKeys: number[];
+    unrequestedReplyKeys: string[];
+};
+/**
+ * Parses an untrusted reply into a {@link TranslationOutput} and reports the key-set gap.
+ *
+ * A partial answer is applied, not rejected — the gap is returned so the caller can report it. Only
+ * a reply that answers nothing is a failure ({@link KeySetMismatchError}).
+ */
+export declare function parseAndValidateReply(input: TranslationInput, raw: string): ParsedReply;

package/dist/translation-providers/shared/parseAndValidateReply.js

@@ -0,0 +1,46 @@
+import { isObject } from "../../core/kernel/utils/isObject";
+import { KeySetMismatchError, UnparseableReplyError } from "./errors";
+/**
+ * Parses an untrusted reply into a {@link TranslationOutput} and reports the key-set gap.
+ *
+ * A partial answer is applied, not rejected — the gap is returned so the caller can report it. Only
+ * a reply that answers nothing is a failure ({@link KeySetMismatchError}).
+ */ export function parseAndValidateReply(input, raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    } catch (cause) {
+        throw new UnparseableReplyError("The provider's reply was not valid JSON.", {
+            cause
+        });
+    }
+    // `isObject` admits arrays: `["a"]` has key "0", so a 0-based input would accept it by coincidence.
+    if (!isObject(parsed) || Array.isArray(parsed)) {
+        throw new UnparseableReplyError("The provider's reply was JSON, but not an object.");
+    }
+    const expectedKeys = new Set(Object.keys(input));
+    const translations = {};
+    const missingInputKeys = [];
+    for (const key of expectedKeys){
+        const value = parsed[key];
+        if (typeof value === "string") {
+            translations[Number(key)] = value;
+        } else {
+            missingInputKeys.push(Number(key));
+        }
+    }
+    const unrequestedReplyKeys = Object.keys(parsed).filter((key)=>!expectedKeys.has(key));
+    if (expectedKeys.size > 0 && Object.keys(translations).length === 0) {
+        const answeredAnyKey = [
+            ...expectedKeys
+        ].some((key)=>Object.hasOwn(parsed, key));
+        throw new KeySetMismatchError(answeredAnyKey ? `The provider's reply carried the requested keys, but none of the ${expectedKeys.size} values was a string.` : `The provider's reply answered none of the ${expectedKeys.size} requested keys.`, missingInputKeys, unrequestedReplyKeys);
+    }
+    return {
+        translations,
+        missingInputKeys,
+        unrequestedReplyKeys
+    };
+}
+
+//# sourceMappingURL=parseAndValidateReply.js.map

package/dist/translation-providers/shared/runDryRun.d.ts

@@ -0,0 +1,20 @@
+import type { TranslationInput, TranslationOutput } from "../../core/domain/translation-providers";
+export type DryRunTransformer = (text: string) => string | Promise<string>;
+/**
+ * Dry-run configuration: a transformer, and optionally a delay that imitates network latency.
+ *
+ * @deprecated Supply your own fake `complete` instead. Remove in next major.
+ * See docs/DEPRECATIONS.md#provider-dry-run
+ */
+export type DryRunConfig = {
+    /** Applied to every non-blank value. */
+    transform: DryRunTransformer;
+    /** Milliseconds to wait before returning. */
+    timeout?: number;
+};
+/**
+ * Simulates a translation without calling anything. Blank values pass through untouched.
+ *
+ * Logs the field count and never field content: the log reaches shared infrastructure.
+ */
+export declare function runDryRun(input: TranslationInput, config: boolean | DryRunConfig): Promise<TranslationOutput>;

package/dist/translation-providers/shared/runDryRun.js

@@ -0,0 +1,17 @@
+const reverse = (text)=>text.split("").reverse().join("");
+/**
+ * Simulates a translation without calling anything. Blank values pass through untouched.
+ *
+ * Logs the field count and never field content: the log reaches shared infrastructure.
+ */ export async function runDryRun(input, config) {
+    console.info(`[payload-plugin-translator] Dry run: simulated ${Object.keys(input).length} field(s), no API call made.`);
+    const { transform = reverse, timeout = 0 } = typeof config === "object" ? config : {};
+    if (timeout > 0) await new Promise((resolve)=>setTimeout(resolve, timeout));
+    const output = {};
+    for (const [key, value] of Object.entries(input)){
+        output[Number(key)] = value.trim() ? await transform(value) : value;
+    }
+    return output;
+}
+
+//# sourceMappingURL=runDryRun.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@focus-reactive/payload-plugin-translator",
-  "version": "0.10.4",
+  "version": "0.11.1",
   "description": "Translation plugin for Payload CMS 3.x. Automatically translate your localized content using any translation provider.",
   "type": "module",
   "license": "MIT",

package/dist/server/shared/guards/collection-guards.d.ts

@@ -1,6 +0,0 @@
-import type { CollectionConfig, SanitizedCollectionConfig } from "payload";
-/**
- * Checks if a collection has drafts enabled.
- * Handles both CollectionConfig and SanitizedCollectionConfig.
- */
-export declare function collectionHasDrafts(collection: CollectionConfig | SanitizedCollectionConfig): boolean;

package/dist/server/shared/guards/collection-guards.js

@@ -1,16 +0,0 @@
-/**
- * Type guard: Checks if versions config is an object (not boolean).
- */ function isVersionsObject(versions) {
-    return typeof versions === "object" && versions !== null;
-}
-/**
- * Checks if a collection has drafts enabled.
- * Handles both CollectionConfig and SanitizedCollectionConfig.
- */ export function collectionHasDrafts(collection) {
-    const { versions } = collection;
-    if (!versions) return false;
-    if (!isVersionsObject(versions)) return false;
-    return "drafts" in versions && Boolean(versions.drafts);
-}
-
-//# sourceMappingURL=collection-guards.js.map