@focus-reactive/payload-plugin-translator 0.1.0

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

@@ -0,0 +1,16 @@
+/**
+ * Normalizes a URL path segment.
+ * - Ensures the path starts with a single slash
+ * - Removes trailing slashes
+ * - Handles empty/whitespace input
+ *
+ * @example
+ * normalizePath('translate')      // '/translate'
+ * normalizePath('/translate')     // '/translate'
+ * normalizePath('/translate/')    // '/translate'
+ * normalizePath('//translate//')  // '/translate'
+ * normalizePath('')               // ''
+ * normalizePath('  ')             // ''
+ */
+export declare function normalizePath(path: string): string;
+//# sourceMappingURL=normalizePath.d.ts.map

package/dist/server/shared/utils/normalizePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizePath.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/utils/normalizePath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD"}

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

@@ -0,0 +1,22 @@
+/**
+ * Normalizes a URL path segment.
+ * - Ensures the path starts with a single slash
+ * - Removes trailing slashes
+ * - Handles empty/whitespace input
+ *
+ * @example
+ * normalizePath('translate')      // '/translate'
+ * normalizePath('/translate')     // '/translate'
+ * normalizePath('/translate/')    // '/translate'
+ * normalizePath('//translate//')  // '/translate'
+ * normalizePath('')               // ''
+ * normalizePath('  ')             // ''
+ */ export function normalizePath(path) {
+    const trimmed = path.trim();
+    if (!trimmed) return '';
+    // Remove leading/trailing slashes, then add single leading slash
+    const normalized = trimmed.replace(/^\/+|\/+$/g, '');
+    return normalized ? `/${normalized}` : '';
+}
+
+//# sourceMappingURL=normalizePath.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/utils/normalizePath.ts"],"sourcesContent":["/**\n * Normalizes a URL path segment.\n * - Ensures the path starts with a single slash\n * - Removes trailing slashes\n * - Handles empty/whitespace input\n *\n * @example\n * normalizePath('translate')      // '/translate'\n * normalizePath('/translate')     // '/translate'\n * normalizePath('/translate/')    // '/translate'\n * normalizePath('//translate//')  // '/translate'\n * normalizePath('')               // ''\n * normalizePath('  ')             // ''\n */\nexport function normalizePath(path: string): string {\n  const trimmed = path.trim()\n  if (!trimmed) return ''\n\n  // Remove leading/trailing slashes, then add single leading slash\n  const normalized = trimmed.replace(/^\\/+|\\/+$/g, '')\n  return normalized ? `/${normalized}` : ''\n}\n"],"names":["normalizePath","path","trimmed","trim","normalized","replace"],"mappings":"AAAA;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASA,cAAcC,IAAY;IACxC,MAAMC,UAAUD,KAAKE,IAAI;IACzB,IAAI,CAACD,SAAS,OAAO;IAErB,iEAAiE;IACjE,MAAME,aAAaF,QAAQG,OAAO,CAAC,cAAc;IACjD,OAAOD,aAAa,CAAC,CAAC,EAAEA,YAAY,GAAG;AACzC"}

package/dist/server/shared/utils/normalizePath.test.d.ts

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

package/dist/server/shared/utils/normalizePath.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizePath.test.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/utils/normalizePath.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,33 @@
+import { describe, it, expect } from 'vitest';
+import { normalizePath } from './normalizePath';
+describe('normalizePath', () => {
+    it('adds leading slash to path without one', () => {
+        expect(normalizePath('translate')).toBe('/translate');
+    });
+    it('keeps single leading slash', () => {
+        expect(normalizePath('/translate')).toBe('/translate');
+    });
+    it('removes trailing slash', () => {
+        expect(normalizePath('/translate/')).toBe('/translate');
+    });
+    it('removes multiple leading and trailing slashes', () => {
+        expect(normalizePath('//translate//')).toBe('/translate');
+    });
+    it('returns empty string for empty input', () => {
+        expect(normalizePath('')).toBe('');
+    });
+    it('returns empty string for whitespace input', () => {
+        expect(normalizePath('  ')).toBe('');
+    });
+    it('returns empty string for only slashes', () => {
+        expect(normalizePath('/')).toBe('');
+        expect(normalizePath('//')).toBe('');
+    });
+    it('handles nested paths', () => {
+        expect(normalizePath('/api/translate')).toBe('/api/translate');
+        expect(normalizePath('api/translate/')).toBe('/api/translate');
+    });
+    it('trims whitespace', () => {
+        expect(normalizePath('  /translate  ')).toBe('/translate');
+    });
+});

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

@@ -0,0 +1,5 @@
+/**
+ * Composes functions left-to-right, passing the result of each to the next.
+ */
+export declare const pipe: <T>(...fns: Array<(x: T) => T>) => (x: T) => T;
+//# sourceMappingURL=pipe.d.ts.map

package/dist/server/shared/utils/pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/utils/pipe.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,IAAI,GACd,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAC7B,GAAG,CAAC,KAAG,CAC6B,CAAA"}

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

@@ -0,0 +1,5 @@
+/**
+ * Composes functions left-to-right, passing the result of each to the next.
+ */ export const pipe = (...fns)=>(x)=>fns.reduce((acc, fn)=>fn(acc), x);
+
+//# sourceMappingURL=pipe.js.map

package/dist/server/shared/utils/pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/utils/pipe.ts"],"sourcesContent":["/**\n * Composes functions left-to-right, passing the result of each to the next.\n */\nexport const pipe =\n  <T>(...fns: Array<(x: T) => T>) =>\n  (x: T): T =>\n    fns.reduce((acc, fn) => fn(acc), x)\n"],"names":["pipe","fns","x","reduce","acc","fn"],"mappings":"AAAA;;CAEC,GACD,OAAO,MAAMA,OACX,CAAI,GAAGC,MACP,CAACC,IACCD,IAAIE,MAAM,CAAC,CAACC,KAAKC,KAAOA,GAAGD,MAAMF,GAAE"}

package/dist/server/shared/utils/pipe.test.d.ts

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

package/dist/server/shared/utils/pipe.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.test.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/utils/pipe.test.ts"],"names":[],"mappings":""}

package/dist/server/shared/utils/pipe.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect } from 'vitest';
+import { pipe } from './pipe';
+describe('pipe', () => {
+    it('returns input unchanged when no functions provided', () => {
+        const result = pipe()(5);
+        expect(result).toBe(5);
+    });
+    it('applies single function', () => {
+        const double = (x) => x * 2;
+        const result = pipe(double)(5);
+        expect(result).toBe(10);
+    });
+    it('composes functions left-to-right', () => {
+        const add1 = (x) => x + 1;
+        const double = (x) => x * 2;
+        const subtract3 = (x) => x - 3;
+        // (5 + 1) * 2 - 3 = 9
+        const result = pipe(add1, double, subtract3)(5);
+        expect(result).toBe(9);
+    });
+    it('works with string transformations', () => {
+        const trim = (s) => s.trim();
+        const upper = (s) => s.toUpperCase();
+        const exclaim = (s) => s + '!';
+        const result = pipe(trim, upper, exclaim)('  hello  ');
+        expect(result).toBe('HELLO!');
+    });
+    it('works with object transformations', () => {
+        const incrementCount = (obj) => ({ ...obj, count: obj.count + 1 });
+        const upperLabel = (obj) => ({ ...obj, label: obj.label.toUpperCase() });
+        const result = pipe(incrementCount, upperLabel)({ count: 0, label: 'test' });
+        expect(result).toEqual({ count: 1, label: 'TEST' });
+    });
+    it('works with array transformations', () => {
+        const addElement = (arr) => [...arr, arr.length];
+        const doubleAll = (arr) => arr.map((x) => x * 2);
+        const result = pipe(addElement, doubleAll)([1, 2, 3]);
+        expect(result).toEqual([2, 4, 6, 6]); // [1,2,3,3] -> [2,4,6,6]
+    });
+    it('maintains type safety', () => {
+        const toString = (x) => x;
+        const parse = (x) => x + 1;
+        // This should compile and work
+        const result = pipe(toString, parse)(42);
+        expect(result).toBe(43);
+    });
+    it('can be reused', () => {
+        const add1 = (x) => x + 1;
+        const double = (x) => x * 2;
+        const transform = pipe(add1, double);
+        expect(transform(1)).toBe(4); // (1 + 1) * 2
+        expect(transform(5)).toBe(12); // (5 + 1) * 2
+        expect(transform(10)).toBe(22); // (10 + 1) * 2
+    });
+});

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

@@ -0,0 +1,11 @@
+/**
+ * Sets a value in an object by dot-notation path.
+ * Creates intermediate objects/arrays as needed.
+ *
+ * @example
+ * const obj = {}
+ * setByPath(obj, 'a.b', 1) // { a: { b: 1 } }
+ * setByPath(obj, 'arr.0.x', 1) // { arr: [{ x: 1 }] }
+ */
+export declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void;
+//# sourceMappingURL=setByPath.d.ts.map

package/dist/server/shared/utils/setByPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setByPath.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/utils/setByPath.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAkB1F"}

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

@@ -0,0 +1,26 @@
+import { isObject } from './isObject';
+/**
+ * Sets a value in an object by dot-notation path.
+ * Creates intermediate objects/arrays as needed.
+ *
+ * @example
+ * const obj = {}
+ * 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('.');
+    let current = obj;
+    for(let i = 0; i < keys.length - 1; i++){
+        const key = keys[i];
+        const nextKey = keys[i + 1];
+        if (!isObject(current[key])) {
+            // Create array if next key is numeric, otherwise object
+            current[key] = /^\d+$/.test(nextKey) ? [] : {};
+        }
+        current = current[key];
+    }
+    const lastKey = keys[keys.length - 1];
+    current[lastKey] = value;
+}
+
+//# sourceMappingURL=setByPath.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/utils/setByPath.ts"],"sourcesContent":["import { isObject } from './isObject'\n\n/**\n * Sets a value in an object by dot-notation path.\n * Creates intermediate objects/arrays as needed.\n *\n * @example\n * const obj = {}\n * setByPath(obj, 'a.b', 1) // { a: { b: 1 } }\n * setByPath(obj, 'arr.0.x', 1) // { arr: [{ x: 1 }] }\n */\nexport function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void {\n  const keys = path.split('.')\n  let current: Record<string, unknown> = obj\n\n  for (let i = 0; i < keys.length - 1; i++) {\n    const key = keys[i]\n    const nextKey = keys[i + 1]\n\n    if (!isObject(current[key])) {\n      // Create array if next key is numeric, otherwise object\n      current[key] = /^\\d+$/.test(nextKey) ? [] : {}\n    }\n\n    current = current[key] as Record<string, unknown>\n  }\n\n  const lastKey = keys[keys.length - 1]\n  current[lastKey] = value\n}\n"],"names":["isObject","setByPath","obj","path","value","keys","split","current","i","length","key","nextKey","test","lastKey"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,aAAY;AAErC;;;;;;;;CAQC,GACD,OAAO,SAASC,UAAUC,GAA4B,EAAEC,IAAY,EAAEC,KAAc;IAClF,MAAMC,OAAOF,KAAKG,KAAK,CAAC;IACxB,IAAIC,UAAmCL;IAEvC,IAAK,IAAIM,IAAI,GAAGA,IAAIH,KAAKI,MAAM,GAAG,GAAGD,IAAK;QACxC,MAAME,MAAML,IAAI,CAACG,EAAE;QACnB,MAAMG,UAAUN,IAAI,CAACG,IAAI,EAAE;QAE3B,IAAI,CAACR,SAASO,OAAO,CAACG,IAAI,GAAG;YAC3B,wDAAwD;YACxDH,OAAO,CAACG,IAAI,GAAG,QAAQE,IAAI,CAACD,WAAW,EAAE,GAAG,CAAC;QAC/C;QAEAJ,UAAUA,OAAO,CAACG,IAAI;IACxB;IAEA,MAAMG,UAAUR,IAAI,CAACA,KAAKI,MAAM,GAAG,EAAE;IACrCF,OAAO,CAACM,QAAQ,GAAGT;AACrB"}

package/dist/server/shared/utils/setByPath.test.d.ts

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

package/dist/server/shared/utils/setByPath.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setByPath.test.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/utils/setByPath.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import { setByPath } from './setByPath';
+describe('setByPath', () => {
+    it('sets top-level property', () => {
+        const obj = {};
+        setByPath(obj, 'title', 'Hello');
+        expect(obj.title).toBe('Hello');
+    });
+    it('sets nested property creating intermediate objects', () => {
+        const obj = {};
+        setByPath(obj, 'a.b.c', 1);
+        expect(obj).toEqual({ a: { b: { c: 1 } } });
+    });
+    it('sets array element creating intermediate array', () => {
+        const obj = {};
+        setByPath(obj, 'arr.0', 'first');
+        expect(obj).toEqual({ arr: ['first'] });
+    });
+    it('sets nested property in array', () => {
+        const obj = {};
+        setByPath(obj, 'items.0.name', 'first');
+        expect(obj).toEqual({ items: [{ name: 'first' }] });
+    });
+    it('overwrites existing value', () => {
+        const obj = { title: 'Old' };
+        setByPath(obj, 'title', 'New');
+        expect(obj.title).toBe('New');
+    });
+    it('preserves existing structure', () => {
+        const obj = { a: { x: 1 } };
+        setByPath(obj, 'a.y', 2);
+        expect(obj).toEqual({ a: { x: 1, y: 2 } });
+    });
+    it('handles complex path with mixed objects and arrays', () => {
+        const obj = {};
+        setByPath(obj, 'body.0.content.root', { children: [] });
+        expect(obj).toEqual({
+            body: [{ content: { root: { children: [] } } }],
+        });
+    });
+    it('sets value in existing array', () => {
+        const obj = { arr: ['a', 'b', 'c'] };
+        setByPath(obj, 'arr.1', 'X');
+        expect(obj.arr).toEqual(['a', 'X', 'c']);
+    });
+});

package/dist/types/AccessGuard.d.ts

@@ -0,0 +1,12 @@
+import type { BasePayload, TypedUser } from 'payload';
+export type AccessGuardRequest = {
+    headers: Headers;
+    user?: TypedUser | null;
+    payload: BasePayload;
+};
+export interface AccessGuard {
+    check<R extends AccessGuardRequest>({ req }: {
+        req: R;
+    }): Promise<boolean> | boolean;
+}
+//# sourceMappingURL=AccessGuard.d.ts.map

package/dist/types/AccessGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessGuard.d.ts","sourceRoot":"","sources":["../../src/types/AccessGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAErD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,CAAC,SAAS,kBAAkB,EAAE,EAAE,GAAG,EAAE,EAAE;QAAE,GAAG,EAAE,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CACrF"}

package/dist/types/AccessGuard.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=AccessGuard.js.map

package/dist/types/AccessGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/AccessGuard.ts"],"sourcesContent":["import type { BasePayload, TypedUser } from 'payload'\n\nexport type AccessGuardRequest = {\n  headers: Headers\n  user?: TypedUser | null\n  payload: BasePayload\n}\n\nexport interface AccessGuard {\n  check<R extends AccessGuardRequest>({ req }: { req: R }): Promise<boolean> | boolean\n}\n"],"names":[],"mappings":"AAQA,WAEC"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export type { AccessGuard, AccessGuardRequest } from './AccessGuard';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["export type { AccessGuard, AccessGuardRequest } from './AccessGuard'\n"],"names":[],"mappings":"AAAA,WAAoE"}

package/dist/vitest-env.d.js

@@ -0,0 +1,3 @@
+/// <reference types="vitest/globals" />
+
+//# sourceMappingURL=vitest-env.d.js.map

package/dist/vitest-env.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vitest-env.d.ts"],"sourcesContent":["/// <reference types=\"vitest/globals\" />\n"],"names":[],"mappings":"AAAA,wCAAwC"}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@focus-reactive/payload-plugin-translator",
+  "version": "0.1.0",
+  "description": "Translation plugin for Payload CMS 3.x. Automatically translate your localized content using any translation provider.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Siarhei Parkhamchuk <siarhei.parkhamchuk@focusreactive.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/focusreactive/payload-plugin-translator.git",
+    "directory": "plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/focusreactive/payload-plugin-translator/issues"
+  },
+  "homepage": "https://github.com/focusreactive/payload-plugin-translator#readme",
+  "keywords": [
+    "payload",
+    "payloadcms",
+    "payload-plugin",
+    "translation",
+    "i18n",
+    "localization",
+    "openai",
+    "ai-translation"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./client/*": {
+      "import": "./dist/client/*",
+      "types": "./dist/client/*"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@payloadcms/richtext-lexical": "^3.76.0",
+    "@payloadcms/ui": "^3.76.0",
+    "payload": "^3.76.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@hookform/resolvers": "^3.9.0",
+    "@radix-ui/react-popover": "^1.1.0",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@tanstack/react-query": "^5.0.0",
+    "classnames": "^2.5.0",
+    "ofetch": "^1.4.0",
+    "react-hook-form": "^7.54.0",
+    "zod": "^3.23.0"
+  },
+  "optionalDependencies": {
+    "openai": "^4.50.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9",
+    "@payloadcms/richtext-lexical": "^3.76.0",
+    "@payloadcms/ui": "^3.76.0",
+    "@swc/cli": "^0.5.2",
+    "@swc/core": "^1.10.0",
+    "@types/react": "^19.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9",
+    "eslint-plugin-react-hooks": "6.0.0-rc.2",
+    "next": "^15.0.0",
+    "payload": "^3.76.0",
+    "react": "^19.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.56.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "pnpm build:types && pnpm build:swc",
+    "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
+    "build:swc": "swc ./src -d ./dist --strip-leading-paths --ignore '**/*.test.ts' --ignore '**/__tests__/**' --ignore '**/__mocks__/**'",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}