@roxxel/payload-multilang 0.0.4 → 0.0.5

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2026 Roxxel
+
+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

@@ -97,13 +97,14 @@ const posts = await payload.find({
 
 ## Translation Helpers
 
+In request-scoped code, use the `WithPayload` helpers with `req.payload`.
+
 ```ts
 import {
-  findGlobalByLanguage,
-  getDocumentTranslation,
-  getDocumentTranslations,
-  getLanguages,
-  updateGlobalByLanguage,
+  findGlobalByLanguageWithPayload,
+  getDocumentTranslationWithPayload,
+  getDocumentTranslationsWithPayload,
+  updateGlobalByLanguageWithPayload,
   withLanguage,
 } from '@roxxel/payload-multilang'
 ```
@@ -111,33 +112,55 @@ import {
 Common examples:
 
 ```ts
-const languages = await getLanguages()
-
-const state = await getDocumentTranslations({
+const state = await getDocumentTranslationsWithPayload({
   collection: 'posts',
   id: post.id,
+  payload: req.payload,
+  req,
+  overrideAccess: false,
 })
 
-const ukrainianPost = await getDocumentTranslation({
+const ukrainianPost = await getDocumentTranslationWithPayload({
   collection: 'posts',
   id: post.id,
   language: 'uk',
+  payload: req.payload,
+  req,
+  overrideAccess: false,
 })
 
-const settings = await findGlobalByLanguage({
+const settings = await findGlobalByLanguageWithPayload({
   slug: 'site-settings',
   language: 'uk',
+  payload: req.payload,
+  req,
+  overrideAccess: false,
 })
 
-await updateGlobalByLanguage({
+await updateGlobalByLanguageWithPayload({
   slug: 'site-settings',
   language: 'uk',
+  payload: req.payload,
+  req,
+  overrideAccess: false,
   data: {
     title: 'Localized title',
   },
 })
 ```
 
+For app-level convenience, create your own configured helper module:
+
+```ts
+import { createMultilangHelpers } from '@roxxel/payload-multilang'
+import { getPayload } from 'payload'
+import config from '@payload-config'
+
+export const multilang = createMultilangHelpers({
+  getPayload: () => getPayload({ config }),
+})
+```
+
 ## Documentation
 
 - [Configuration](./docs/configuration.md)

package/dist/constants.d.ts

@@ -1,5 +1,8 @@
 import type { MultilangFieldNames } from './types.js';
 export declare const DEFAULT_FIELD_NAMES: MultilangFieldNames;
+export declare const MULTILANG_GROUP_FIELD: string;
+export declare const MULTILANG_LANGUAGE_FIELD: string;
+export declare const MULTILANG_META_FIELD: string;
 export declare const DEFAULT_GLOBAL_TABS_LABEL = "Localized content";
 export declare const DEFAULT_DUPLICATE_EXCLUDE_FIELDS: string[];
 export declare const MULTILANG_SKIP_HOOK = "payloadMultilangSkip";

package/dist/constants.js

@@ -3,6 +3,9 @@ export const DEFAULT_FIELD_NAMES = {
     language: '_multilangLanguage',
     meta: '_multilangMeta'
 };
+export const MULTILANG_GROUP_FIELD = DEFAULT_FIELD_NAMES.group;
+export const MULTILANG_LANGUAGE_FIELD = DEFAULT_FIELD_NAMES.language;
+export const MULTILANG_META_FIELD = DEFAULT_FIELD_NAMES.meta;
 export const DEFAULT_GLOBAL_TABS_LABEL = 'Localized content';
 export const DEFAULT_DUPLICATE_EXCLUDE_FIELDS = [
     'id',

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["import type { MultilangFieldNames } from './types.js'\n\nexport const DEFAULT_FIELD_NAMES: MultilangFieldNames = {\n  group: '_multilangGroup',\n  language: '_multilangLanguage',\n  meta: '_multilangMeta',\n}\n\nexport const DEFAULT_GLOBAL_TABS_LABEL = 'Localized content'\n\nexport const DEFAULT_DUPLICATE_EXCLUDE_FIELDS = [\n  'id',\n  'createdAt',\n  'updatedAt',\n  'deletedAt',\n  '_status',\n  'sizes',\n  'filename',\n  'filesize',\n  'height',\n  'mimeType',\n  'thumbnailURL',\n  'url',\n  'width',\n]\n\nexport const MULTILANG_SKIP_HOOK = 'payloadMultilangSkip'\n"],"names":["DEFAULT_FIELD_NAMES","group","language","meta","DEFAULT_GLOBAL_TABS_LABEL","DEFAULT_DUPLICATE_EXCLUDE_FIELDS","MULTILANG_SKIP_HOOK"],"mappings":"AAEA,OAAO,MAAMA,sBAA2C;IACtDC,OAAO;IACPC,UAAU;IACVC,MAAM;AACR,EAAC;AAED,OAAO,MAAMC,4BAA4B,oBAAmB;AAE5D,OAAO,MAAMC,mCAAmC;IAC9C;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAED,OAAO,MAAMC,sBAAsB,uBAAsB"}
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["import type { MultilangFieldNames } from './types.js'\n\nexport const DEFAULT_FIELD_NAMES: MultilangFieldNames = {\n  group: '_multilangGroup',\n  language: '_multilangLanguage',\n  meta: '_multilangMeta',\n}\n\nexport const MULTILANG_GROUP_FIELD = DEFAULT_FIELD_NAMES.group\nexport const MULTILANG_LANGUAGE_FIELD = DEFAULT_FIELD_NAMES.language\nexport const MULTILANG_META_FIELD = DEFAULT_FIELD_NAMES.meta\n\nexport const DEFAULT_GLOBAL_TABS_LABEL = 'Localized content'\n\nexport const DEFAULT_DUPLICATE_EXCLUDE_FIELDS = [\n  'id',\n  'createdAt',\n  'updatedAt',\n  'deletedAt',\n  '_status',\n  'sizes',\n  'filename',\n  'filesize',\n  'height',\n  'mimeType',\n  'thumbnailURL',\n  'url',\n  'width',\n]\n\nexport const MULTILANG_SKIP_HOOK = 'payloadMultilangSkip'\n"],"names":["DEFAULT_FIELD_NAMES","group","language","meta","MULTILANG_GROUP_FIELD","MULTILANG_LANGUAGE_FIELD","MULTILANG_META_FIELD","DEFAULT_GLOBAL_TABS_LABEL","DEFAULT_DUPLICATE_EXCLUDE_FIELDS","MULTILANG_SKIP_HOOK"],"mappings":"AAEA,OAAO,MAAMA,sBAA2C;IACtDC,OAAO;IACPC,UAAU;IACVC,MAAM;AACR,EAAC;AAED,OAAO,MAAMC,wBAAwBJ,oBAAoBC,KAAK,CAAA;AAC9D,OAAO,MAAMI,2BAA2BL,oBAAoBE,QAAQ,CAAA;AACpE,OAAO,MAAMI,uBAAuBN,oBAAoBG,IAAI,CAAA;AAE5D,OAAO,MAAMI,4BAA4B,oBAAmB;AAE5D,OAAO,MAAMC,mCAAmC;IAC9C;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAED,OAAO,MAAMC,sBAAsB,uBAAsB"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import type { Plugin } from 'payload';
 import type { PayloadMultilangConfig } from './types.js';
-export { findGlobalByLanguage, findGlobalByLanguageWithPayload, getDocumentTranslation, getDocumentTranslations, getLanguages, updateGlobalByLanguage, updateGlobalByLanguageWithPayload, withLanguage, } from './lib/data.js';
+export { DEFAULT_FIELD_NAMES, MULTILANG_GROUP_FIELD, MULTILANG_LANGUAGE_FIELD, MULTILANG_META_FIELD, } from './constants.js';
+export { createMultilangHelpers, findGlobalByLanguageWithPayload, getDocumentTranslationsWithPayload, getDocumentTranslationWithPayload, getGroupTranslationsWithPayload, getMultilangDocumentLanguage, localizedSlugQuery, updateGlobalByLanguageWithPayload, withLanguage, } from './lib/data.js';
+export type { FindGlobalByLanguageArgs, GetDocumentTranslationArgs, GetDocumentTranslationsArgs, LocalizedSlugQuery, LocalizedSlugQueryArgs, LocalizedSlugQueryStatus, MultilangDocumentLanguageArgs, MultilangHelpers, PayloadFactory, UpdateGlobalByLanguageArgs, } from './lib/data.js';
 export type { MultilangCollectionOptions, MultilangFieldNames, MultilangGlobalOptions, MultilangLanguage, PayloadMultilangConfig, ResolvedMultilangGlobal, TranslationMap, TranslationState, } from './types.js';
 export declare const payloadMultilang: (pluginOptions?: PayloadMultilangConfig) => Plugin;

package/dist/index.js

@@ -2,13 +2,17 @@ import { createTranslationEndpoints } from './endpoints/translations.js';
 import { withTranslatedCollection } from './hooks/translatedCollection.js';
 import { withTranslatedGlobal } from './hooks/translatedGlobal.js';
 import { getCollectionConfig, getGlobalConfig, sanitizePluginConfig } from './lib/config.js';
-export { findGlobalByLanguage, findGlobalByLanguageWithPayload, getDocumentTranslation, getDocumentTranslations, getLanguages, updateGlobalByLanguage, updateGlobalByLanguageWithPayload, withLanguage } from './lib/data.js';
+export { DEFAULT_FIELD_NAMES, MULTILANG_GROUP_FIELD, MULTILANG_LANGUAGE_FIELD, MULTILANG_META_FIELD } from './constants.js';
+export { createMultilangHelpers, findGlobalByLanguageWithPayload, getDocumentTranslationsWithPayload, getDocumentTranslationWithPayload, getGroupTranslationsWithPayload, getMultilangDocumentLanguage, localizedSlugQuery, updateGlobalByLanguageWithPayload, withLanguage } from './lib/data.js';
 export const payloadMultilang = (pluginOptions = {
     languages: []
 })=>(config)=>{
         if (pluginOptions.disabled) {
             return config;
         }
+        if (config.localization) {
+            throw new Error('payload-multilang uses per-language documents and cannot run with Payload built-in localization enabled. Set localization: false and do not use localized: true fields for this plugin model.');
+        }
         const pluginConfig = sanitizePluginConfig(pluginOptions);
         const incomingCollections = config.collections || [];
         const collections = incomingCollections.map((collection)=>{

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { CollectionConfig, Config, GlobalConfig, Plugin } from 'payload'\n\nimport type { PayloadMultilangConfig } from './types.js'\n\nimport { createTranslationEndpoints } from './endpoints/translations.js'\nimport { withTranslatedCollection } from './hooks/translatedCollection.js'\nimport { withTranslatedGlobal } from './hooks/translatedGlobal.js'\nimport {\n  getCollectionConfig,\n  getGlobalConfig,\n  sanitizePluginConfig,\n} from './lib/config.js'\n\nexport {\n  findGlobalByLanguage,\n  findGlobalByLanguageWithPayload,\n  getDocumentTranslation,\n  getDocumentTranslations,\n  getLanguages,\n  updateGlobalByLanguage,\n  updateGlobalByLanguageWithPayload,\n  withLanguage,\n} from './lib/data.js'\n\nexport type {\n  MultilangCollectionOptions,\n  MultilangFieldNames,\n  MultilangGlobalOptions,\n  MultilangLanguage,\n  PayloadMultilangConfig,\n  ResolvedMultilangGlobal,\n  TranslationMap,\n  TranslationState,\n} from './types.js'\n\nexport const payloadMultilang =\n  (pluginOptions: PayloadMultilangConfig = { languages: [] }): Plugin =>\n  (config: Config): Config => {\n    if (pluginOptions.disabled) {\n      return config\n    }\n\n    const pluginConfig = sanitizePluginConfig(pluginOptions)\n\n    const incomingCollections = config.collections || []\n    const collections = incomingCollections.map(\n      (collection): CollectionConfig => {\n        const translatedCollection = getCollectionConfig(\n          pluginConfig.collections,\n          collection.slug,\n        )\n\n        if (!translatedCollection) {\n          return collection\n        }\n\n        const translated = withTranslatedCollection({\n          collection: translatedCollection,\n          config: collection,\n        })\n\n        return {\n          ...translated,\n          endpoints: [\n            ...(translated.endpoints || []),\n            ...createTranslationEndpoints({\n              collection: translatedCollection,\n              collectionConfig: collection,\n            }),\n          ],\n        }\n      },\n    )\n\n    const incomingGlobals = config.globals || []\n    const globals = incomingGlobals.map((globalConfig): GlobalConfig => {\n      const translatedGlobal = getGlobalConfig(\n        pluginConfig.globals,\n        globalConfig.slug,\n      )\n\n      if (!translatedGlobal) {\n        return globalConfig\n      }\n\n      return withTranslatedGlobal({\n        config: globalConfig,\n        global: translatedGlobal,\n      })\n    })\n\n    return {\n      ...config,\n      admin: {\n        ...config.admin,\n        custom: {\n          ...config.admin?.custom,\n          payloadMultilang: {\n            ...((config.admin?.custom as\n              | { payloadMultilang?: Record<string, unknown> }\n              | undefined)?.payloadMultilang || {}),\n            defaultLanguage: pluginConfig.defaultLanguage,\n            languages: pluginConfig.languages,\n          },\n        },\n      },\n      collections,\n      globals,\n    }\n  }\n"],"names":["createTranslationEndpoints","withTranslatedCollection","withTranslatedGlobal","getCollectionConfig","getGlobalConfig","sanitizePluginConfig","findGlobalByLanguage","findGlobalByLanguageWithPayload","getDocumentTranslation","getDocumentTranslations","getLanguages","updateGlobalByLanguage","updateGlobalByLanguageWithPayload","withLanguage","payloadMultilang","pluginOptions","languages","config","disabled","pluginConfig","incomingCollections","collections","map","collection","translatedCollection","slug","translated","endpoints","collectionConfig","incomingGlobals","globals","globalConfig","translatedGlobal","global","admin","custom","defaultLanguage"],"mappings":"AAIA,SAASA,0BAA0B,QAAQ,8BAA6B;AACxE,SAASC,wBAAwB,QAAQ,kCAAiC;AAC1E,SAASC,oBAAoB,QAAQ,8BAA6B;AAClE,SACEC,mBAAmB,EACnBC,eAAe,EACfC,oBAAoB,QACf,kBAAiB;AAExB,SACEC,oBAAoB,EACpBC,+BAA+B,EAC/BC,sBAAsB,EACtBC,uBAAuB,EACvBC,YAAY,EACZC,sBAAsB,EACtBC,iCAAiC,EACjCC,YAAY,QACP,gBAAe;AAatB,OAAO,MAAMC,mBACX,CAACC,gBAAwC;IAAEC,WAAW,EAAE;AAAC,CAAC,GAC1D,CAACC;QACC,IAAIF,cAAcG,QAAQ,EAAE;YAC1B,OAAOD;QACT;QAEA,MAAME,eAAed,qBAAqBU;QAE1C,MAAMK,sBAAsBH,OAAOI,WAAW,IAAI,EAAE;QACpD,MAAMA,cAAcD,oBAAoBE,GAAG,CACzC,CAACC;YACC,MAAMC,uBAAuBrB,oBAC3BgB,aAAaE,WAAW,EACxBE,WAAWE,IAAI;YAGjB,IAAI,CAACD,sBAAsB;gBACzB,OAAOD;YACT;YAEA,MAAMG,aAAazB,yBAAyB;gBAC1CsB,YAAYC;gBACZP,QAAQM;YACV;YAEA,OAAO;gBACL,GAAGG,UAAU;gBACbC,WAAW;uBACLD,WAAWC,SAAS,IAAI,EAAE;uBAC3B3B,2BAA2B;wBAC5BuB,YAAYC;wBACZI,kBAAkBL;oBACpB;iBACD;YACH;QACF;QAGF,MAAMM,kBAAkBZ,OAAOa,OAAO,IAAI,EAAE;QAC5C,MAAMA,UAAUD,gBAAgBP,GAAG,CAAC,CAACS;YACnC,MAAMC,mBAAmB5B,gBACvBe,aAAaW,OAAO,EACpBC,aAAaN,IAAI;YAGnB,IAAI,CAACO,kBAAkB;gBACrB,OAAOD;YACT;YAEA,OAAO7B,qBAAqB;gBAC1Be,QAAQc;gBACRE,QAAQD;YACV;QACF;QAEA,OAAO;YACL,GAAGf,MAAM;YACTiB,OAAO;gBACL,GAAGjB,OAAOiB,KAAK;gBACfC,QAAQ;oBACN,GAAGlB,OAAOiB,KAAK,EAAEC,MAAM;oBACvBrB,kBAAkB;wBAChB,GAAI,AAACG,OAAOiB,KAAK,EAAEC,QAEHrB,oBAAoB,CAAC,CAAC;wBACtCsB,iBAAiBjB,aAAaiB,eAAe;wBAC7CpB,WAAWG,aAAaH,SAAS;oBACnC;gBACF;YACF;YACAK;YACAS;QACF;IACF,EAAC"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { CollectionConfig, Config, GlobalConfig, Plugin } from 'payload'\n\nimport type { PayloadMultilangConfig } from './types.js'\n\nimport { createTranslationEndpoints } from './endpoints/translations.js'\nimport { withTranslatedCollection } from './hooks/translatedCollection.js'\nimport { withTranslatedGlobal } from './hooks/translatedGlobal.js'\nimport {\n  getCollectionConfig,\n  getGlobalConfig,\n  sanitizePluginConfig,\n} from './lib/config.js'\n\nexport {\n  DEFAULT_FIELD_NAMES,\n  MULTILANG_GROUP_FIELD,\n  MULTILANG_LANGUAGE_FIELD,\n  MULTILANG_META_FIELD,\n} from './constants.js'\n\nexport {\n  createMultilangHelpers,\n  findGlobalByLanguageWithPayload,\n  getDocumentTranslationsWithPayload,\n  getDocumentTranslationWithPayload,\n  getGroupTranslationsWithPayload,\n  getMultilangDocumentLanguage,\n  localizedSlugQuery,\n  updateGlobalByLanguageWithPayload,\n  withLanguage,\n} from './lib/data.js'\n\nexport type {\n  FindGlobalByLanguageArgs,\n  GetDocumentTranslationArgs,\n  GetDocumentTranslationsArgs,\n  LocalizedSlugQuery,\n  LocalizedSlugQueryArgs,\n  LocalizedSlugQueryStatus,\n  MultilangDocumentLanguageArgs,\n  MultilangHelpers,\n  PayloadFactory,\n  UpdateGlobalByLanguageArgs,\n} from './lib/data.js'\n\nexport type {\n  MultilangCollectionOptions,\n  MultilangFieldNames,\n  MultilangGlobalOptions,\n  MultilangLanguage,\n  PayloadMultilangConfig,\n  ResolvedMultilangGlobal,\n  TranslationMap,\n  TranslationState,\n} from './types.js'\n\nexport const payloadMultilang =\n  (pluginOptions: PayloadMultilangConfig = { languages: [] }): Plugin =>\n  (config: Config): Config => {\n    if (pluginOptions.disabled) {\n      return config\n    }\n\n    if (config.localization) {\n      throw new Error(\n        'payload-multilang uses per-language documents and cannot run with Payload built-in localization enabled. Set localization: false and do not use localized: true fields for this plugin model.',\n      )\n    }\n\n    const pluginConfig = sanitizePluginConfig(pluginOptions)\n\n    const incomingCollections = config.collections || []\n    const collections = incomingCollections.map(\n      (collection): CollectionConfig => {\n        const translatedCollection = getCollectionConfig(\n          pluginConfig.collections,\n          collection.slug,\n        )\n\n        if (!translatedCollection) {\n          return collection\n        }\n\n        const translated = withTranslatedCollection({\n          collection: translatedCollection,\n          config: collection,\n        })\n\n        return {\n          ...translated,\n          endpoints: [\n            ...(translated.endpoints || []),\n            ...createTranslationEndpoints({\n              collection: translatedCollection,\n              collectionConfig: collection,\n            }),\n          ],\n        }\n      },\n    )\n\n    const incomingGlobals = config.globals || []\n    const globals = incomingGlobals.map((globalConfig): GlobalConfig => {\n      const translatedGlobal = getGlobalConfig(\n        pluginConfig.globals,\n        globalConfig.slug,\n      )\n\n      if (!translatedGlobal) {\n        return globalConfig\n      }\n\n      return withTranslatedGlobal({\n        config: globalConfig,\n        global: translatedGlobal,\n      })\n    })\n\n    return {\n      ...config,\n      admin: {\n        ...config.admin,\n        custom: {\n          ...config.admin?.custom,\n          payloadMultilang: {\n            ...((config.admin?.custom as\n              | { payloadMultilang?: Record<string, unknown> }\n              | undefined)?.payloadMultilang || {}),\n            defaultLanguage: pluginConfig.defaultLanguage,\n            languages: pluginConfig.languages,\n          },\n        },\n      },\n      collections,\n      globals,\n    }\n  }\n"],"names":["createTranslationEndpoints","withTranslatedCollection","withTranslatedGlobal","getCollectionConfig","getGlobalConfig","sanitizePluginConfig","DEFAULT_FIELD_NAMES","MULTILANG_GROUP_FIELD","MULTILANG_LANGUAGE_FIELD","MULTILANG_META_FIELD","createMultilangHelpers","findGlobalByLanguageWithPayload","getDocumentTranslationsWithPayload","getDocumentTranslationWithPayload","getGroupTranslationsWithPayload","getMultilangDocumentLanguage","localizedSlugQuery","updateGlobalByLanguageWithPayload","withLanguage","payloadMultilang","pluginOptions","languages","config","disabled","localization","Error","pluginConfig","incomingCollections","collections","map","collection","translatedCollection","slug","translated","endpoints","collectionConfig","incomingGlobals","globals","globalConfig","translatedGlobal","global","admin","custom","defaultLanguage"],"mappings":"AAIA,SAASA,0BAA0B,QAAQ,8BAA6B;AACxE,SAASC,wBAAwB,QAAQ,kCAAiC;AAC1E,SAASC,oBAAoB,QAAQ,8BAA6B;AAClE,SACEC,mBAAmB,EACnBC,eAAe,EACfC,oBAAoB,QACf,kBAAiB;AAExB,SACEC,mBAAmB,EACnBC,qBAAqB,EACrBC,wBAAwB,EACxBC,oBAAoB,QACf,iBAAgB;AAEvB,SACEC,sBAAsB,EACtBC,+BAA+B,EAC/BC,kCAAkC,EAClCC,iCAAiC,EACjCC,+BAA+B,EAC/BC,4BAA4B,EAC5BC,kBAAkB,EAClBC,iCAAiC,EACjCC,YAAY,QACP,gBAAe;AA0BtB,OAAO,MAAMC,mBACX,CAACC,gBAAwC;IAAEC,WAAW,EAAE;AAAC,CAAC,GAC1D,CAACC;QACC,IAAIF,cAAcG,QAAQ,EAAE;YAC1B,OAAOD;QACT;QAEA,IAAIA,OAAOE,YAAY,EAAE;YACvB,MAAM,IAAIC,MACR;QAEJ;QAEA,MAAMC,eAAerB,qBAAqBe;QAE1C,MAAMO,sBAAsBL,OAAOM,WAAW,IAAI,EAAE;QACpD,MAAMA,cAAcD,oBAAoBE,GAAG,CACzC,CAACC;YACC,MAAMC,uBAAuB5B,oBAC3BuB,aAAaE,WAAW,EACxBE,WAAWE,IAAI;YAGjB,IAAI,CAACD,sBAAsB;gBACzB,OAAOD;YACT;YAEA,MAAMG,aAAahC,yBAAyB;gBAC1C6B,YAAYC;gBACZT,QAAQQ;YACV;YAEA,OAAO;gBACL,GAAGG,UAAU;gBACbC,WAAW;uBACLD,WAAWC,SAAS,IAAI,EAAE;uBAC3BlC,2BAA2B;wBAC5B8B,YAAYC;wBACZI,kBAAkBL;oBACpB;iBACD;YACH;QACF;QAGF,MAAMM,kBAAkBd,OAAOe,OAAO,IAAI,EAAE;QAC5C,MAAMA,UAAUD,gBAAgBP,GAAG,CAAC,CAACS;YACnC,MAAMC,mBAAmBnC,gBACvBsB,aAAaW,OAAO,EACpBC,aAAaN,IAAI;YAGnB,IAAI,CAACO,kBAAkB;gBACrB,OAAOD;YACT;YAEA,OAAOpC,qBAAqB;gBAC1BoB,QAAQgB;gBACRE,QAAQD;YACV;QACF;QAEA,OAAO;YACL,GAAGjB,MAAM;YACTmB,OAAO;gBACL,GAAGnB,OAAOmB,KAAK;gBACfC,QAAQ;oBACN,GAAGpB,OAAOmB,KAAK,EAAEC,MAAM;oBACvBvB,kBAAkB;wBAChB,GAAI,AAACG,OAAOmB,KAAK,EAAEC,QAEHvB,oBAAoB,CAAC,CAAC;wBACtCwB,iBAAiBjB,aAAaiB,eAAe;wBAC7CtB,WAAWK,aAAaL,SAAS;oBACnC;gBACF;YACF;YACAO;YACAS;QACF;IACF,EAAC"}

package/dist/lib/data.d.ts

@@ -11,18 +11,17 @@ type ConfigWithMultilang = Pick<Config, 'admin'> | Pick<Payload['config'], 'admi
 export declare const getLanguagesFromCustom: (custom: unknown) => MultilangLanguage[];
 /**
  * Returns the languages configured for payload-multilang.
- *
- * Pass `languages` or a Payload `config` object when you already have them. Otherwise the helper
- * resolves the cached Payload config from `@payload-config`.
  */
-export declare const getLanguages: ({ config, languages, }?: {
+export declare const getLanguages: ({ config, languages, payload, }?: {
     config?: ConfigWithMultilang;
     languages?: MultilangLanguage[];
-}) => Promise<MultilangLanguage[]>;
-export declare const getDefaultLanguage: ({ config, languages, }: {
+    payload?: Payload;
+}) => MultilangLanguage[];
+export declare const getDefaultLanguage: ({ config, languages, payload, }: {
     config?: ConfigWithMultilang;
     languages?: MultilangLanguage[];
-}) => Promise<MultilangLanguage | undefined>;
+    payload?: Payload;
+}) => MultilangLanguage | undefined;
 /**
  * Adds a language constraint to a Payload `where` query.
  *
@@ -30,6 +29,36 @@ export declare const getDefaultLanguage: ({ config, languages, }: {
  * payload-multilang language.
  */
 export declare const withLanguage: ({ fieldName, language, where, }: WithLanguageArgs) => Where;
+export type MultilangDocumentLanguageArgs = {
+    data?: unknown;
+    doc?: unknown;
+    fallback?: string;
+    fieldName?: string;
+};
+/**
+ * Resolves a document's payload-multilang language from draft/form data first, then persisted doc data.
+ *
+ * Useful in Payload admin preview and livePreview URL builders where unsaved form data may already
+ * contain the selected language.
+ */
+export declare const getMultilangDocumentLanguage: ({ data, doc, fallback, fieldName, }: MultilangDocumentLanguageArgs) => string | undefined;
+export type LocalizedSlugQueryStatus = 'any' | 'draft' | 'published';
+export type LocalizedSlugQueryArgs = {
+    fieldName?: string;
+    language: string;
+    slug: string;
+    slugFieldName?: string;
+    status?: LocalizedSlugQueryStatus;
+    where?: Where;
+};
+export type LocalizedSlugQuery = {
+    draft?: boolean;
+    where: Where;
+};
+/**
+ * Builds the common Payload Local API query for per-language documents addressed by slug.
+ */
+export declare const localizedSlugQuery: ({ slug, fieldName, language, slugFieldName, status, where, }: LocalizedSlugQueryArgs) => LocalizedSlugQuery;
 export declare const getDocumentTranslationsWithPayload: <TDoc extends DocumentData = DocumentData>({ id, collection, fieldNames, overrideAccess, payload, req, }: {
     collection: CollectionSlug;
     fieldNames?: MultilangFieldNames;
@@ -48,26 +77,15 @@ export declare const getGroupTranslationsWithPayload: <TDoc extends DocumentData
 }) => Promise<TranslationState<TDoc>>;
 /**
  * Returns the source document and every document in the same translation group, keyed by language.
- *
- * The helper resolves Payload with the cached project config, so callers only need to pass the
- * collection slug and document id.
- */
-export declare const getDocumentTranslations: <TDoc extends DocumentData = DocumentData>({ id, collection, fieldNames, }: {
-    collection: CollectionSlug;
-    fieldNames?: MultilangFieldNames;
-    id: number | string;
-}) => Promise<TranslationState<TDoc>>;
-/**
- * Returns one target-language document from the source document's translation group.
- *
- * The helper resolves Payload with the cached project config, so callers only need to pass the
- * collection slug, source document id, and target language code.
  */
-export declare const getDocumentTranslation: <TDoc extends DocumentData = DocumentData>({ id, collection, fieldNames, language, }: {
+export declare const getDocumentTranslationWithPayload: <TDoc extends DocumentData = DocumentData>({ id, collection, fieldNames, language, overrideAccess, payload, req, }: {
     collection: CollectionSlug;
     fieldNames?: MultilangFieldNames;
     id: number | string;
     language: string;
+    overrideAccess?: boolean;
+    payload: Payload;
+    req?: PayloadRequest;
 }) => Promise<TDoc | undefined>;
 export declare const findGlobalByLanguageWithPayload: <TDoc extends DocumentData = DocumentData>({ slug, depth, language, overrideAccess, payload, req, }: {
     depth?: number;
@@ -86,17 +104,6 @@ export declare const updateGlobalByLanguageWithPayload: <TDoc extends DocumentDa
     req?: PayloadRequest;
     slug: GlobalSlug;
 }) => Promise<TDoc>;
-export declare const findGlobalByLanguage: <TDoc extends DocumentData = DocumentData>({ slug, depth, language, }: {
-    depth?: number;
-    language: string;
-    slug: GlobalSlug;
-}) => Promise<TDoc>;
-export declare const updateGlobalByLanguage: <TDoc extends DocumentData = DocumentData>({ slug, data, depth, language, }: {
-    data: Record<string, unknown>;
-    depth?: number;
-    language: string;
-    slug: GlobalSlug;
-}) => Promise<TDoc>;
 export declare const duplicateDocumentData: ({ collection, doc, duplicateExcludeFields, fieldNames, targetLanguage, }: {
     collection: CollectionConfig;
     doc: DocumentData;
@@ -104,4 +111,35 @@ export declare const duplicateDocumentData: ({ collection, doc, duplicateExclude
     fieldNames: MultilangFieldNames;
     targetLanguage: string;
 }) => DocumentData;
+export type PayloadFactory = () => Payload | Promise<Payload>;
+export type GetDocumentTranslationsArgs = {
+    collection: CollectionSlug;
+    fieldNames?: MultilangFieldNames;
+    id: number | string;
+    overrideAccess?: boolean;
+    req?: PayloadRequest;
+};
+export type GetDocumentTranslationArgs = {
+    language: string;
+} & GetDocumentTranslationsArgs;
+export type FindGlobalByLanguageArgs = {
+    depth?: number;
+    language: string;
+    overrideAccess?: boolean;
+    req?: PayloadRequest;
+    slug: GlobalSlug;
+};
+export type UpdateGlobalByLanguageArgs = {
+    data: Record<string, unknown>;
+} & FindGlobalByLanguageArgs;
+export type MultilangHelpers = {
+    findGlobalByLanguage: <TDoc extends DocumentData = DocumentData>(args: FindGlobalByLanguageArgs) => Promise<TDoc>;
+    getDocumentTranslation: <TDoc extends DocumentData = DocumentData>(args: GetDocumentTranslationArgs) => Promise<TDoc | undefined>;
+    getDocumentTranslations: <TDoc extends DocumentData = DocumentData>(args: GetDocumentTranslationsArgs) => Promise<TranslationState<TDoc>>;
+    getLanguages: () => Promise<MultilangLanguage[]>;
+    updateGlobalByLanguage: <TDoc extends DocumentData = DocumentData>(args: UpdateGlobalByLanguageArgs) => Promise<TDoc>;
+};
+export declare const createMultilangHelpers: ({ getPayload, }: {
+    getPayload: PayloadFactory;
+}) => MultilangHelpers;
 export {};

package/dist/lib/data.js

@@ -1,5 +1,3 @@
-import payloadConfig from '@payload-config';
-import { getPayload } from 'payload';
 import { DEFAULT_FIELD_NAMES } from '../constants.js';
 export const asDocument = (value)=>value && typeof value === 'object' ? value : {};
 export const getStringValue = (value)=>typeof value === 'string' && value.length > 0 ? value : undefined;
@@ -29,25 +27,23 @@ export const getLanguagesFromCustom = (custom)=>{
 };
 /**
  * Returns the languages configured for payload-multilang.
- *
- * Pass `languages` or a Payload `config` object when you already have them. Otherwise the helper
- * resolves the cached Payload config from `@payload-config`.
- */ export const getLanguages = async ({ config, languages } = {})=>{
+ */ export const getLanguages = ({ config, languages, payload } = {})=>{
     if (languages) {
         return languages.map(normalizeLanguage).filter((language)=>language.code);
     }
+    if (payload) {
+        return getLanguagesFromCustom(payload.config.admin?.custom);
+    }
     if (config) {
         return getLanguagesFromCustom(config.admin?.custom);
     }
-    const payload = await getPayload({
-        config: payloadConfig
-    });
-    return getLanguagesFromCustom(payload.config.admin?.custom);
+    throw new Error('getLanguages requires languages, config, or payload. Use createMultilangHelpers({ getPayload }) for app-level convenience.');
 };
-export const getDefaultLanguage = async ({ config, languages })=>{
-    const configuredLanguages = await getLanguages({
+export const getDefaultLanguage = ({ config, languages, payload })=>{
+    const configuredLanguages = getLanguages({
         config,
-        languages
+        languages,
+        payload
     });
     return configuredLanguages.find((language)=>language.isDefault) || configuredLanguages[0];
 };
@@ -72,6 +68,46 @@ export const getDefaultLanguage = async ({ config, languages })=>{
         ]
     };
 };
+/**
+ * Resolves a document's payload-multilang language from draft/form data first, then persisted doc data.
+ *
+ * Useful in Payload admin preview and livePreview URL builders where unsaved form data may already
+ * contain the selected language.
+ */ export const getMultilangDocumentLanguage = ({ data, doc, fallback, fieldName = DEFAULT_FIELD_NAMES.language })=>getStringValue(asDocument(data)[fieldName]) || getStringValue(asDocument(doc)[fieldName]) || fallback;
+/**
+ * Builds the common Payload Local API query for per-language documents addressed by slug.
+ */ export const localizedSlugQuery = ({ slug, fieldName = DEFAULT_FIELD_NAMES.language, language, slugFieldName = 'slug', status = 'published', where })=>{
+    const constraints = [
+        {
+            [slugFieldName]: {
+                equals: slug
+            }
+        },
+        {
+            [fieldName]: {
+                equals: language
+            }
+        }
+    ];
+    if (where) {
+        constraints.unshift(where);
+    }
+    if (status !== 'any') {
+        constraints.push({
+            _status: {
+                equals: status
+            }
+        });
+    }
+    return {
+        ...status === 'draft' ? {
+            draft: true
+        } : {},
+        where: constraints.length === 1 ? constraints[0] : {
+            and: constraints
+        }
+    };
+};
 export const getDocumentTranslationsWithPayload = async ({ id, collection, fieldNames = DEFAULT_FIELD_NAMES, overrideAccess = true, payload, req })=>{
     const source = asDocument(await payload.findByID({
         id,
@@ -146,30 +182,14 @@ export const getGroupTranslationsWithPayload = async ({ collection, fieldNames =
 };
 /**
  * Returns the source document and every document in the same translation group, keyed by language.
- *
- * The helper resolves Payload with the cached project config, so callers only need to pass the
- * collection slug and document id.
- */ export const getDocumentTranslations = async ({ id, collection, fieldNames })=>{
-    const payload = await getPayload({
-        config: payloadConfig
-    });
-    return getDocumentTranslationsWithPayload({
+ */ export const getDocumentTranslationWithPayload = async ({ id, collection, fieldNames, language, overrideAccess = true, payload, req })=>{
+    const state = await getDocumentTranslationsWithPayload({
         id,
         collection,
         fieldNames,
-        payload
-    });
-};
-/**
- * Returns one target-language document from the source document's translation group.
- *
- * The helper resolves Payload with the cached project config, so callers only need to pass the
- * collection slug, source document id, and target language code.
- */ export const getDocumentTranslation = async ({ id, collection, fieldNames, language })=>{
-    const state = await getDocumentTranslations({
-        id,
-        collection,
-        fieldNames
+        overrideAccess,
+        payload,
+        req
     });
     return state.translations[language];
 };
@@ -257,29 +277,6 @@ export const updateGlobalByLanguageWithPayload = async ({ slug, data, depth, lan
         language
     });
 };
-export const findGlobalByLanguage = async ({ slug, depth, language })=>{
-    const payload = await getPayload({
-        config: payloadConfig
-    });
-    return findGlobalByLanguageWithPayload({
-        slug,
-        depth,
-        language,
-        payload
-    });
-};
-export const updateGlobalByLanguage = async ({ slug, data, depth, language })=>{
-    const payload = await getPayload({
-        config: payloadConfig
-    });
-    return updateGlobalByLanguageWithPayload({
-        slug,
-        data,
-        depth,
-        language,
-        payload
-    });
-};
 const fieldAffectsData = (field)=>'name' in field && typeof field.name === 'string' && field.type !== 'ui';
 export const duplicateDocumentData = ({ collection, doc, duplicateExcludeFields, fieldNames, targetLanguage })=>{
     const excluded = new Set([
@@ -303,5 +300,38 @@ export const duplicateDocumentData = ({ collection, doc, duplicateExcludeFields,
     }
     return data;
 };
+export const createMultilangHelpers = ({ getPayload })=>{
+    const resolvePayload = async ()=>getPayload();
+    return {
+        findGlobalByLanguage: async ({ slug, depth, language, overrideAccess, req })=>findGlobalByLanguageWithPayload({
+                slug,
+                depth,
+                language,
+                overrideAccess,
+                payload: await resolvePayload(),
+                req
+            }),
+        getDocumentTranslation: async (args)=>getDocumentTranslationWithPayload({
+                ...args,
+                payload: await resolvePayload()
+            }),
+        getDocumentTranslations: async (args)=>getDocumentTranslationsWithPayload({
+                ...args,
+                payload: await resolvePayload()
+            }),
+        getLanguages: async ()=>getLanguages({
+                payload: await resolvePayload()
+            }),
+        updateGlobalByLanguage: async ({ slug, data, depth, language, overrideAccess, req })=>updateGlobalByLanguageWithPayload({
+                slug,
+                data,
+                depth,
+                language,
+                overrideAccess,
+                payload: await resolvePayload(),
+                req
+            })
+    };
+};
 
 //# sourceMappingURL=data.js.map

package/dist/lib/data.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/data.ts"],"sourcesContent":["import type {\n  CollectionConfig,\n  CollectionSlug,\n  Config,\n  Field,\n  GlobalSlug,\n  Payload,\n  PayloadRequest,\n  Where,\n} from 'payload'\n\nimport payloadConfig from '@payload-config'\nimport { getPayload } from 'payload'\n\nimport type {\n  MultilangFieldNames,\n  MultilangLanguage,\n  TranslationState,\n  WithLanguageArgs,\n} from '../types.js'\n\nimport { DEFAULT_FIELD_NAMES } from '../constants.js'\n\nexport type DocumentData = {\n  id?: number | string\n} & Record<string, unknown>\n\nexport const asDocument = (value: unknown): DocumentData =>\n  value && typeof value === 'object' ? (value as DocumentData) : {}\n\nexport const getStringValue = (value: unknown): string | undefined =>\n  typeof value === 'string' && value.length > 0 ? value : undefined\n\nexport const getID = (value: unknown): number | string | undefined =>\n  typeof value === 'number' || typeof value === 'string' ? value : undefined\n\nexport const normalizeLanguage = (doc: unknown): MultilangLanguage => {\n  const data = asDocument(doc)\n  const code = getStringValue(data.code)?.trim().toLowerCase() || ''\n\n  return {\n    id: getID(data.id),\n    name: getStringValue(data.name)?.trim() || code,\n    active: data.active !== false,\n    code,\n    direction: data.direction === 'rtl' ? 'rtl' : 'ltr',\n    flagLabel: getStringValue(data.flagLabel),\n    isDefault: data.isDefault === true,\n    locale: getStringValue(data.locale),\n    order: typeof data.order === 'number' ? data.order : 0,\n  }\n}\n\ntype ConfigWithMultilang = Pick<Config, 'admin'> | Pick<Payload['config'], 'admin'>\n\nexport const getLanguagesFromCustom = (custom: unknown): MultilangLanguage[] => {\n  const payloadMultilang = asDocument(asDocument(custom).payloadMultilang)\n  const languages = payloadMultilang.languages\n\n  if (!Array.isArray(languages)) {\n    return []\n  }\n\n  return languages.map(normalizeLanguage).filter((language) => language.code)\n}\n\n/**\n * Returns the languages configured for payload-multilang.\n *\n * Pass `languages` or a Payload `config` object when you already have them. Otherwise the helper\n * resolves the cached Payload config from `@payload-config`.\n */\nexport const getLanguages = async ({\n  config,\n  languages,\n}: {\n  config?: ConfigWithMultilang\n  languages?: MultilangLanguage[]\n} = {}): Promise<MultilangLanguage[]> => {\n  if (languages) {\n    return languages.map(normalizeLanguage).filter((language) => language.code)\n  }\n\n  if (config) {\n    return getLanguagesFromCustom(config.admin?.custom)\n  }\n\n  const payload = await getPayload({ config: payloadConfig })\n\n  return getLanguagesFromCustom(payload.config.admin?.custom)\n}\n\nexport const getDefaultLanguage = async ({\n  config,\n  languages,\n}: {\n  config?: ConfigWithMultilang\n  languages?: MultilangLanguage[]\n}): Promise<MultilangLanguage | undefined> => {\n  const configuredLanguages = await getLanguages({ config, languages })\n\n  return configuredLanguages.find((language) => language.isDefault) || configuredLanguages[0]\n}\n\n/**\n * Adds a language constraint to a Payload `where` query.\n *\n * Use this when querying an enabled collection directly and you only want documents for one\n * payload-multilang language.\n */\nexport const withLanguage = ({\n  fieldName = DEFAULT_FIELD_NAMES.language,\n  language,\n  where,\n}: WithLanguageArgs): Where => {\n  const languageWhere: Where = {\n    [fieldName]: {\n      equals: language,\n    },\n  }\n\n  if (!where) {\n    return languageWhere\n  }\n\n  return {\n    and: [where, languageWhere],\n  }\n}\n\nexport const getDocumentTranslationsWithPayload = async <TDoc extends DocumentData = DocumentData>({\n  id,\n  collection,\n  fieldNames = DEFAULT_FIELD_NAMES,\n  overrideAccess = true,\n  payload,\n  req,\n}: {\n  collection: CollectionSlug\n  fieldNames?: MultilangFieldNames\n  id: number | string\n  overrideAccess?: boolean\n  payload: Payload\n  req?: PayloadRequest\n}): Promise<TranslationState<TDoc>> => {\n  const source = asDocument(\n    await payload.findByID({\n      id,\n      collection,\n      depth: 0,\n      overrideAccess,\n      req,\n    }),\n  ) as TDoc\n\n  const group = getStringValue(source[fieldNames.group])\n  const language = getStringValue(source[fieldNames.language])\n\n  if (!group) {\n    return {\n      language,\n      source,\n      translations: language ? { [language]: source } : {},\n    }\n  }\n\n  const result = await payload.find({\n    collection,\n    depth: 0,\n    limit: 200,\n    overrideAccess,\n    req,\n    where: {\n      [fieldNames.group]: {\n        equals: group,\n      },\n    },\n  })\n\n  const translations = result.docs.reduce<TranslationState<TDoc>['translations']>((acc, doc) => {\n    const translation = asDocument(doc) as TDoc\n    const code = getStringValue(translation[fieldNames.language])\n\n    if (code) {\n      acc[code] = translation\n    }\n\n    return acc\n  }, {})\n\n  return {\n    group,\n    language,\n    source,\n    translations,\n  }\n}\n\nexport const getGroupTranslationsWithPayload = async <TDoc extends DocumentData = DocumentData>({\n  collection,\n  fieldNames = DEFAULT_FIELD_NAMES,\n  group,\n  overrideAccess = true,\n  payload,\n  req,\n}: {\n  collection: CollectionSlug\n  fieldNames?: MultilangFieldNames\n  group: string\n  overrideAccess?: boolean\n  payload: Payload\n  req?: PayloadRequest\n}): Promise<TranslationState<TDoc>> => {\n  const result = await payload.find({\n    collection,\n    depth: 0,\n    limit: 200,\n    overrideAccess,\n    req,\n    where: {\n      [fieldNames.group]: {\n        equals: group,\n      },\n    },\n  })\n\n  const translations = result.docs.reduce<TranslationState<TDoc>['translations']>((acc, doc) => {\n    const translation = asDocument(doc) as TDoc\n    const code = getStringValue(translation[fieldNames.language])\n\n    if (code) {\n      acc[code] = translation\n    }\n\n    return acc\n  }, {})\n\n  return {\n    group,\n    translations,\n  }\n}\n\n/**\n * Returns the source document and every document in the same translation group, keyed by language.\n *\n * The helper resolves Payload with the cached project config, so callers only need to pass the\n * collection slug and document id.\n */\nexport const getDocumentTranslations = async <TDoc extends DocumentData = DocumentData>({\n  id,\n  collection,\n  fieldNames,\n}: {\n  collection: CollectionSlug\n  fieldNames?: MultilangFieldNames\n  id: number | string\n}): Promise<TranslationState<TDoc>> => {\n  const payload = await getPayload({ config: payloadConfig })\n\n  return getDocumentTranslationsWithPayload<TDoc>({\n    id,\n    collection,\n    fieldNames,\n    payload,\n  })\n}\n\n/**\n * Returns one target-language document from the source document's translation group.\n *\n * The helper resolves Payload with the cached project config, so callers only need to pass the\n * collection slug, source document id, and target language code.\n */\nexport const getDocumentTranslation = async <TDoc extends DocumentData = DocumentData>({\n  id,\n  collection,\n  fieldNames,\n  language,\n}: {\n  collection: CollectionSlug\n  fieldNames?: MultilangFieldNames\n  id: number | string\n  language: string\n}): Promise<TDoc | undefined> => {\n  const state = await getDocumentTranslations<TDoc>({\n    id,\n    collection,\n    fieldNames,\n  })\n\n  return state.translations[language]\n}\n\nconst GLOBAL_SYSTEM_FIELDS = new Set(['_status', 'createdAt', 'globalType', 'id', 'updatedAt'])\n\nconst getGlobalPayloadMultilangCustom = ({\n  slug,\n  payload,\n}: {\n  payload: Payload\n  slug: GlobalSlug\n}): {\n  defaultLanguage?: MultilangLanguage\n  languages?: MultilangLanguage[]\n} => {\n  const global = payload.config.globals.find((item) => item.slug === slug)\n  const payloadMultilang = asDocument(asDocument(global?.admin?.custom).payloadMultilang)\n\n  return payloadMultilang as {\n    defaultLanguage?: MultilangLanguage\n    languages?: MultilangLanguage[]\n  }\n}\n\nconst validateGlobalLanguage = ({\n  slug,\n  language,\n  payload,\n}: {\n  language: string\n  payload: Payload\n  slug: GlobalSlug\n}): void => {\n  const languages = getGlobalPayloadMultilangCustom({ slug, payload }).languages\n\n  if (!Array.isArray(languages) || languages.length === 0) {\n    return\n  }\n\n  if (!languages.some((candidate) => candidate.code === language)) {\n    throw new Error(`Language \"${language}\" is not configured for ${slug}.`)\n  }\n}\n\nconst getGlobalLanguageTab = <TDoc extends DocumentData = DocumentData>({\n  doc,\n  language,\n}: {\n  doc: DocumentData\n  language: string\n}): TDoc => {\n  const languageData = asDocument(doc[language])\n  const systemData = Object.entries(doc).reduce<DocumentData>((acc, [key, value]) => {\n    if (GLOBAL_SYSTEM_FIELDS.has(key)) {\n      acc[key] = value\n    }\n\n    return acc\n  }, {})\n\n  return {\n    ...systemData,\n    ...languageData,\n  } as TDoc\n}\n\nexport const findGlobalByLanguageWithPayload = async <TDoc extends DocumentData = DocumentData>({\n  slug,\n  depth,\n  language,\n  overrideAccess = true,\n  payload,\n  req,\n}: {\n  depth?: number\n  language: string\n  overrideAccess?: boolean\n  payload: Payload\n  req?: PayloadRequest\n  slug: GlobalSlug\n}): Promise<TDoc> => {\n  validateGlobalLanguage({ slug, language, payload })\n\n  const doc = asDocument(\n    await payload.findGlobal({\n      slug,\n      depth,\n      overrideAccess,\n      req,\n    } as never),\n  )\n\n  return getGlobalLanguageTab<TDoc>({\n    doc,\n    language,\n  })\n}\n\nexport const updateGlobalByLanguageWithPayload = async <TDoc extends DocumentData = DocumentData>({\n  slug,\n  data,\n  depth,\n  language,\n  overrideAccess = true,\n  payload,\n  req,\n}: {\n  data: Record<string, unknown>\n  depth?: number\n  language: string\n  overrideAccess?: boolean\n  payload: Payload\n  req?: PayloadRequest\n  slug: GlobalSlug\n}): Promise<TDoc> => {\n  validateGlobalLanguage({ slug, language, payload })\n\n  const currentDoc = asDocument(\n    await payload.findGlobal({\n      slug,\n      depth: 0,\n      overrideAccess,\n      req,\n    } as never),\n  )\n  const currentLanguageData = asDocument(currentDoc[language])\n\n  const doc = asDocument(\n    await payload.updateGlobal({\n      slug,\n      data: {\n        [language]: {\n          ...currentLanguageData,\n          ...data,\n        },\n      },\n      depth,\n      overrideAccess,\n      req,\n    } as never),\n  )\n\n  return getGlobalLanguageTab<TDoc>({\n    doc,\n    language,\n  })\n}\n\nexport const findGlobalByLanguage = async <TDoc extends DocumentData = DocumentData>({\n  slug,\n  depth,\n  language,\n}: {\n  depth?: number\n  language: string\n  slug: GlobalSlug\n}): Promise<TDoc> => {\n  const payload = await getPayload({ config: payloadConfig })\n\n  return findGlobalByLanguageWithPayload<TDoc>({\n    slug,\n    depth,\n    language,\n    payload,\n  })\n}\n\nexport const updateGlobalByLanguage = async <TDoc extends DocumentData = DocumentData>({\n  slug,\n  data,\n  depth,\n  language,\n}: {\n  data: Record<string, unknown>\n  depth?: number\n  language: string\n  slug: GlobalSlug\n}): Promise<TDoc> => {\n  const payload = await getPayload({ config: payloadConfig })\n\n  return updateGlobalByLanguageWithPayload<TDoc>({\n    slug,\n    data,\n    depth,\n    language,\n    payload,\n  })\n}\n\nconst fieldAffectsData = (field: Field): field is { name: string } & Field =>\n  'name' in field && typeof field.name === 'string' && field.type !== 'ui'\n\nexport const duplicateDocumentData = ({\n  collection,\n  doc,\n  duplicateExcludeFields,\n  fieldNames,\n  targetLanguage,\n}: {\n  collection: CollectionConfig\n  doc: DocumentData\n  duplicateExcludeFields: string[]\n  fieldNames: MultilangFieldNames\n  targetLanguage: string\n}): DocumentData => {\n  const excluded = new Set([\n    fieldNames.group,\n    fieldNames.language,\n    fieldNames.meta,\n    ...duplicateExcludeFields,\n  ])\n\n  const data: DocumentData = {}\n\n  for (const field of collection.fields || []) {\n    if (!fieldAffectsData(field) || excluded.has(field.name)) {\n      continue\n    }\n\n    if (!(field.name in doc)) {\n      continue\n    }\n\n    data[field.name] = doc[field.name]\n  }\n\n  if (typeof data.slug === 'string' && data.slug.length > 0) {\n    data.slug = `${data.slug}-${targetLanguage}`\n  }\n\n  return data\n}\n"],"names":["payloadConfig","getPayload","DEFAULT_FIELD_NAMES","asDocument","value","getStringValue","length","undefined","getID","normalizeLanguage","doc","data","code","trim","toLowerCase","id","name","active","direction","flagLabel","isDefault","locale","order","getLanguagesFromCustom","custom","payloadMultilang","languages","Array","isArray","map","filter","language","getLanguages","config","admin","payload","getDefaultLanguage","configuredLanguages","find","withLanguage","fieldName","where","languageWhere","equals","and","getDocumentTranslationsWithPayload","collection","fieldNames","overrideAccess","req","source","findByID","depth","group","translations","result","limit","docs","reduce","acc","translation","getGroupTranslationsWithPayload","getDocumentTranslations","getDocumentTranslation","state","GLOBAL_SYSTEM_FIELDS","Set","getGlobalPayloadMultilangCustom","slug","global","globals","item","validateGlobalLanguage","some","candidate","Error","getGlobalLanguageTab","languageData","systemData","Object","entries","key","has","findGlobalByLanguageWithPayload","findGlobal","updateGlobalByLanguageWithPayload","currentDoc","currentLanguageData","updateGlobal","findGlobalByLanguage","updateGlobalByLanguage","fieldAffectsData","field","type","duplicateDocumentData","duplicateExcludeFields","targetLanguage","excluded","meta","fields"],"mappings":"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"}
+{"version":3,"sources":["../../src/lib/data.ts"],"sourcesContent":["import type {\n  CollectionConfig,\n  CollectionSlug,\n  Config,\n  Field,\n  GlobalSlug,\n  Payload,\n  PayloadRequest,\n  Where,\n} from 'payload'\n\nimport type {\n  MultilangFieldNames,\n  MultilangLanguage,\n  TranslationState,\n  WithLanguageArgs,\n} from '../types.js'\n\nimport { DEFAULT_FIELD_NAMES } from '../constants.js'\n\nexport type DocumentData = {\n  id?: number | string\n} & Record<string, unknown>\n\nexport const asDocument = (value: unknown): DocumentData =>\n  value && typeof value === 'object' ? (value as DocumentData) : {}\n\nexport const getStringValue = (value: unknown): string | undefined =>\n  typeof value === 'string' && value.length > 0 ? value : undefined\n\nexport const getID = (value: unknown): number | string | undefined =>\n  typeof value === 'number' || typeof value === 'string' ? value : undefined\n\nexport const normalizeLanguage = (doc: unknown): MultilangLanguage => {\n  const data = asDocument(doc)\n  const code = getStringValue(data.code)?.trim().toLowerCase() || ''\n\n  return {\n    id: getID(data.id),\n    name: getStringValue(data.name)?.trim() || code,\n    active: data.active !== false,\n    code,\n    direction: data.direction === 'rtl' ? 'rtl' : 'ltr',\n    flagLabel: getStringValue(data.flagLabel),\n    isDefault: data.isDefault === true,\n    locale: getStringValue(data.locale),\n    order: typeof data.order === 'number' ? data.order : 0,\n  }\n}\n\ntype ConfigWithMultilang = Pick<Config, 'admin'> | Pick<Payload['config'], 'admin'>\n\nexport const getLanguagesFromCustom = (custom: unknown): MultilangLanguage[] => {\n  const payloadMultilang = asDocument(asDocument(custom).payloadMultilang)\n  const languages = payloadMultilang.languages\n\n  if (!Array.isArray(languages)) {\n    return []\n  }\n\n  return languages.map(normalizeLanguage).filter((language) => language.code)\n}\n\n/**\n * Returns the languages configured for payload-multilang.\n */\nexport const getLanguages = ({\n  config,\n  languages,\n  payload,\n}: {\n  config?: ConfigWithMultilang\n  languages?: MultilangLanguage[]\n  payload?: Payload\n} = {}): MultilangLanguage[] => {\n  if (languages) {\n    return languages.map(normalizeLanguage).filter((language) => language.code)\n  }\n\n  if (payload) {\n    return getLanguagesFromCustom(payload.config.admin?.custom)\n  }\n\n  if (config) {\n    return getLanguagesFromCustom(config.admin?.custom)\n  }\n\n  throw new Error(\n    'getLanguages requires languages, config, or payload. Use createMultilangHelpers({ getPayload }) for app-level convenience.',\n  )\n}\n\nexport const getDefaultLanguage = ({\n  config,\n  languages,\n  payload,\n}: {\n  config?: ConfigWithMultilang\n  languages?: MultilangLanguage[]\n  payload?: Payload\n}): MultilangLanguage | undefined => {\n  const configuredLanguages = getLanguages({ config, languages, payload })\n\n  return configuredLanguages.find((language) => language.isDefault) || configuredLanguages[0]\n}\n\n/**\n * Adds a language constraint to a Payload `where` query.\n *\n * Use this when querying an enabled collection directly and you only want documents for one\n * payload-multilang language.\n */\nexport const withLanguage = ({\n  fieldName = DEFAULT_FIELD_NAMES.language,\n  language,\n  where,\n}: WithLanguageArgs): Where => {\n  const languageWhere: Where = {\n    [fieldName]: {\n      equals: language,\n    },\n  }\n\n  if (!where) {\n    return languageWhere\n  }\n\n  return {\n    and: [where, languageWhere],\n  }\n}\n\nexport type MultilangDocumentLanguageArgs = {\n  data?: unknown\n  doc?: unknown\n  fallback?: string\n  fieldName?: string\n}\n\n/**\n * Resolves a document's payload-multilang language from draft/form data first, then persisted doc data.\n *\n * Useful in Payload admin preview and livePreview URL builders where unsaved form data may already\n * contain the selected language.\n */\nexport const getMultilangDocumentLanguage = ({\n  data,\n  doc,\n  fallback,\n  fieldName = DEFAULT_FIELD_NAMES.language,\n}: MultilangDocumentLanguageArgs): string | undefined =>\n  getStringValue(asDocument(data)[fieldName]) ||\n  getStringValue(asDocument(doc)[fieldName]) ||\n  fallback\n\nexport type LocalizedSlugQueryStatus = 'any' | 'draft' | 'published'\n\nexport type LocalizedSlugQueryArgs = {\n  fieldName?: string\n  language: string\n  slug: string\n  slugFieldName?: string\n  status?: LocalizedSlugQueryStatus\n  where?: Where\n}\n\nexport type LocalizedSlugQuery = {\n  draft?: boolean\n  where: Where\n}\n\n/**\n * Builds the common Payload Local API query for per-language documents addressed by slug.\n */\nexport const localizedSlugQuery = ({\n  slug,\n  fieldName = DEFAULT_FIELD_NAMES.language,\n  language,\n  slugFieldName = 'slug',\n  status = 'published',\n  where,\n}: LocalizedSlugQueryArgs): LocalizedSlugQuery => {\n  const constraints: Where[] = [\n    {\n      [slugFieldName]: {\n        equals: slug,\n      },\n    },\n    {\n      [fieldName]: {\n        equals: language,\n      },\n    },\n  ]\n\n  if (where) {\n    constraints.unshift(where)\n  }\n\n  if (status !== 'any') {\n    constraints.push({\n      _status: {\n        equals: status,\n      },\n    })\n  }\n\n  return {\n    ...(status === 'draft' ? { draft: true } : {}),\n    where:\n      constraints.length === 1\n        ? constraints[0]\n        : {\n            and: constraints,\n          },\n  }\n}\n\nexport const getDocumentTranslationsWithPayload = async <TDoc extends DocumentData = DocumentData>({\n  id,\n  collection,\n  fieldNames = DEFAULT_FIELD_NAMES,\n  overrideAccess = true,\n  payload,\n  req,\n}: {\n  collection: CollectionSlug\n  fieldNames?: MultilangFieldNames\n  id: number | string\n  overrideAccess?: boolean\n  payload: Payload\n  req?: PayloadRequest\n}): Promise<TranslationState<TDoc>> => {\n  const source = asDocument(\n    await payload.findByID({\n      id,\n      collection,\n      depth: 0,\n      overrideAccess,\n      req,\n    }),\n  ) as TDoc\n\n  const group = getStringValue(source[fieldNames.group])\n  const language = getStringValue(source[fieldNames.language])\n\n  if (!group) {\n    return {\n      language,\n      source,\n      translations: language ? { [language]: source } : {},\n    }\n  }\n\n  const result = await payload.find({\n    collection,\n    depth: 0,\n    limit: 200,\n    overrideAccess,\n    req,\n    where: {\n      [fieldNames.group]: {\n        equals: group,\n      },\n    },\n  })\n\n  const translations = result.docs.reduce<TranslationState<TDoc>['translations']>((acc, doc) => {\n    const translation = asDocument(doc) as TDoc\n    const code = getStringValue(translation[fieldNames.language])\n\n    if (code) {\n      acc[code] = translation\n    }\n\n    return acc\n  }, {})\n\n  return {\n    group,\n    language,\n    source,\n    translations,\n  }\n}\n\nexport const getGroupTranslationsWithPayload = async <TDoc extends DocumentData = DocumentData>({\n  collection,\n  fieldNames = DEFAULT_FIELD_NAMES,\n  group,\n  overrideAccess = true,\n  payload,\n  req,\n}: {\n  collection: CollectionSlug\n  fieldNames?: MultilangFieldNames\n  group: string\n  overrideAccess?: boolean\n  payload: Payload\n  req?: PayloadRequest\n}): Promise<TranslationState<TDoc>> => {\n  const result = await payload.find({\n    collection,\n    depth: 0,\n    limit: 200,\n    overrideAccess,\n    req,\n    where: {\n      [fieldNames.group]: {\n        equals: group,\n      },\n    },\n  })\n\n  const translations = result.docs.reduce<TranslationState<TDoc>['translations']>((acc, doc) => {\n    const translation = asDocument(doc) as TDoc\n    const code = getStringValue(translation[fieldNames.language])\n\n    if (code) {\n      acc[code] = translation\n    }\n\n    return acc\n  }, {})\n\n  return {\n    group,\n    translations,\n  }\n}\n\n/**\n * Returns the source document and every document in the same translation group, keyed by language.\n */\nexport const getDocumentTranslationWithPayload = async <TDoc extends DocumentData = DocumentData>({\n  id,\n  collection,\n  fieldNames,\n  language,\n  overrideAccess = true,\n  payload,\n  req,\n}: {\n  collection: CollectionSlug\n  fieldNames?: MultilangFieldNames\n  id: number | string\n  language: string\n  overrideAccess?: boolean\n  payload: Payload\n  req?: PayloadRequest\n}): Promise<TDoc | undefined> => {\n  const state = await getDocumentTranslationsWithPayload<TDoc>({\n    id,\n    collection,\n    fieldNames,\n    overrideAccess,\n    payload,\n    req,\n  })\n\n  return state.translations[language]\n}\n\nconst GLOBAL_SYSTEM_FIELDS = new Set(['_status', 'createdAt', 'globalType', 'id', 'updatedAt'])\n\nconst getGlobalPayloadMultilangCustom = ({\n  slug,\n  payload,\n}: {\n  payload: Payload\n  slug: GlobalSlug\n}): {\n  defaultLanguage?: MultilangLanguage\n  languages?: MultilangLanguage[]\n} => {\n  const global = payload.config.globals.find((item) => item.slug === slug)\n  const payloadMultilang = asDocument(asDocument(global?.admin?.custom).payloadMultilang)\n\n  return payloadMultilang as {\n    defaultLanguage?: MultilangLanguage\n    languages?: MultilangLanguage[]\n  }\n}\n\nconst validateGlobalLanguage = ({\n  slug,\n  language,\n  payload,\n}: {\n  language: string\n  payload: Payload\n  slug: GlobalSlug\n}): void => {\n  const languages = getGlobalPayloadMultilangCustom({ slug, payload }).languages\n\n  if (!Array.isArray(languages) || languages.length === 0) {\n    return\n  }\n\n  if (!languages.some((candidate) => candidate.code === language)) {\n    throw new Error(`Language \"${language}\" is not configured for ${slug}.`)\n  }\n}\n\nconst getGlobalLanguageTab = <TDoc extends DocumentData = DocumentData>({\n  doc,\n  language,\n}: {\n  doc: DocumentData\n  language: string\n}): TDoc => {\n  const languageData = asDocument(doc[language])\n  const systemData = Object.entries(doc).reduce<DocumentData>((acc, [key, value]) => {\n    if (GLOBAL_SYSTEM_FIELDS.has(key)) {\n      acc[key] = value\n    }\n\n    return acc\n  }, {})\n\n  return {\n    ...systemData,\n    ...languageData,\n  } as TDoc\n}\n\nexport const findGlobalByLanguageWithPayload = async <TDoc extends DocumentData = DocumentData>({\n  slug,\n  depth,\n  language,\n  overrideAccess = true,\n  payload,\n  req,\n}: {\n  depth?: number\n  language: string\n  overrideAccess?: boolean\n  payload: Payload\n  req?: PayloadRequest\n  slug: GlobalSlug\n}): Promise<TDoc> => {\n  validateGlobalLanguage({ slug, language, payload })\n\n  const doc = asDocument(\n    await payload.findGlobal({\n      slug,\n      depth,\n      overrideAccess,\n      req,\n    } as never),\n  )\n\n  return getGlobalLanguageTab<TDoc>({\n    doc,\n    language,\n  })\n}\n\nexport const updateGlobalByLanguageWithPayload = async <TDoc extends DocumentData = DocumentData>({\n  slug,\n  data,\n  depth,\n  language,\n  overrideAccess = true,\n  payload,\n  req,\n}: {\n  data: Record<string, unknown>\n  depth?: number\n  language: string\n  overrideAccess?: boolean\n  payload: Payload\n  req?: PayloadRequest\n  slug: GlobalSlug\n}): Promise<TDoc> => {\n  validateGlobalLanguage({ slug, language, payload })\n\n  const currentDoc = asDocument(\n    await payload.findGlobal({\n      slug,\n      depth: 0,\n      overrideAccess,\n      req,\n    } as never),\n  )\n  const currentLanguageData = asDocument(currentDoc[language])\n\n  const doc = asDocument(\n    await payload.updateGlobal({\n      slug,\n      data: {\n        [language]: {\n          ...currentLanguageData,\n          ...data,\n        },\n      },\n      depth,\n      overrideAccess,\n      req,\n    } as never),\n  )\n\n  return getGlobalLanguageTab<TDoc>({\n    doc,\n    language,\n  })\n}\n\nconst fieldAffectsData = (field: Field): field is { name: string } & Field =>\n  'name' in field && typeof field.name === 'string' && field.type !== 'ui'\n\nexport const duplicateDocumentData = ({\n  collection,\n  doc,\n  duplicateExcludeFields,\n  fieldNames,\n  targetLanguage,\n}: {\n  collection: CollectionConfig\n  doc: DocumentData\n  duplicateExcludeFields: string[]\n  fieldNames: MultilangFieldNames\n  targetLanguage: string\n}): DocumentData => {\n  const excluded = new Set([\n    fieldNames.group,\n    fieldNames.language,\n    fieldNames.meta,\n    ...duplicateExcludeFields,\n  ])\n\n  const data: DocumentData = {}\n\n  for (const field of collection.fields || []) {\n    if (!fieldAffectsData(field) || excluded.has(field.name)) {\n      continue\n    }\n\n    if (!(field.name in doc)) {\n      continue\n    }\n\n    data[field.name] = doc[field.name]\n  }\n\n  if (typeof data.slug === 'string' && data.slug.length > 0) {\n    data.slug = `${data.slug}-${targetLanguage}`\n  }\n\n  return data\n}\n\nexport type PayloadFactory = () => Payload | Promise<Payload>\n\nexport type GetDocumentTranslationsArgs = {\n  collection: CollectionSlug\n  fieldNames?: MultilangFieldNames\n  id: number | string\n  overrideAccess?: boolean\n  req?: PayloadRequest\n}\n\nexport type GetDocumentTranslationArgs = {\n  language: string\n} & GetDocumentTranslationsArgs\n\nexport type FindGlobalByLanguageArgs = {\n  depth?: number\n  language: string\n  overrideAccess?: boolean\n  req?: PayloadRequest\n  slug: GlobalSlug\n}\n\nexport type UpdateGlobalByLanguageArgs = {\n  data: Record<string, unknown>\n} & FindGlobalByLanguageArgs\n\nexport type MultilangHelpers = {\n  findGlobalByLanguage: <TDoc extends DocumentData = DocumentData>(\n    args: FindGlobalByLanguageArgs,\n  ) => Promise<TDoc>\n  getDocumentTranslation: <TDoc extends DocumentData = DocumentData>(\n    args: GetDocumentTranslationArgs,\n  ) => Promise<TDoc | undefined>\n  getDocumentTranslations: <TDoc extends DocumentData = DocumentData>(\n    args: GetDocumentTranslationsArgs,\n  ) => Promise<TranslationState<TDoc>>\n  getLanguages: () => Promise<MultilangLanguage[]>\n  updateGlobalByLanguage: <TDoc extends DocumentData = DocumentData>(\n    args: UpdateGlobalByLanguageArgs,\n  ) => Promise<TDoc>\n}\n\nexport const createMultilangHelpers = ({\n  getPayload,\n}: {\n  getPayload: PayloadFactory\n}): MultilangHelpers => {\n  const resolvePayload = async () => getPayload()\n\n  return {\n    findGlobalByLanguage: async <TDoc extends DocumentData = DocumentData>({\n      slug,\n      depth,\n      language,\n      overrideAccess,\n      req,\n    }: FindGlobalByLanguageArgs): Promise<TDoc> =>\n      findGlobalByLanguageWithPayload<TDoc>({\n        slug,\n        depth,\n        language,\n        overrideAccess,\n        payload: await resolvePayload(),\n        req,\n      }),\n\n    getDocumentTranslation: async <TDoc extends DocumentData = DocumentData>(\n      args: GetDocumentTranslationArgs,\n    ): Promise<TDoc | undefined> =>\n      getDocumentTranslationWithPayload<TDoc>({\n        ...args,\n        payload: await resolvePayload(),\n      }),\n\n    getDocumentTranslations: async <TDoc extends DocumentData = DocumentData>(\n      args: GetDocumentTranslationsArgs,\n    ): Promise<TranslationState<TDoc>> =>\n      getDocumentTranslationsWithPayload<TDoc>({\n        ...args,\n        payload: await resolvePayload(),\n      }),\n\n    getLanguages: async (): Promise<MultilangLanguage[]> =>\n      getLanguages({ payload: await resolvePayload() }),\n\n    updateGlobalByLanguage: async <TDoc extends DocumentData = DocumentData>({\n      slug,\n      data,\n      depth,\n      language,\n      overrideAccess,\n      req,\n    }: UpdateGlobalByLanguageArgs): Promise<TDoc> =>\n      updateGlobalByLanguageWithPayload<TDoc>({\n        slug,\n        data,\n        depth,\n        language,\n        overrideAccess,\n        payload: await resolvePayload(),\n        req,\n      }),\n  }\n}\n"],"names":["DEFAULT_FIELD_NAMES","asDocument","value","getStringValue","length","undefined","getID","normalizeLanguage","doc","data","code","trim","toLowerCase","id","name","active","direction","flagLabel","isDefault","locale","order","getLanguagesFromCustom","custom","payloadMultilang","languages","Array","isArray","map","filter","language","getLanguages","config","payload","admin","Error","getDefaultLanguage","configuredLanguages","find","withLanguage","fieldName","where","languageWhere","equals","and","getMultilangDocumentLanguage","fallback","localizedSlugQuery","slug","slugFieldName","status","constraints","unshift","push","_status","draft","getDocumentTranslationsWithPayload","collection","fieldNames","overrideAccess","req","source","findByID","depth","group","translations","result","limit","docs","reduce","acc","translation","getGroupTranslationsWithPayload","getDocumentTranslationWithPayload","state","GLOBAL_SYSTEM_FIELDS","Set","getGlobalPayloadMultilangCustom","global","globals","item","validateGlobalLanguage","some","candidate","getGlobalLanguageTab","languageData","systemData","Object","entries","key","has","findGlobalByLanguageWithPayload","findGlobal","updateGlobalByLanguageWithPayload","currentDoc","currentLanguageData","updateGlobal","fieldAffectsData","field","type","duplicateDocumentData","duplicateExcludeFields","targetLanguage","excluded","meta","fields","createMultilangHelpers","getPayload","resolvePayload","findGlobalByLanguage","getDocumentTranslation","args","getDocumentTranslations","updateGlobalByLanguage"],"mappings":"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"}

package/docs/configuration.md

@@ -32,6 +32,8 @@ export default buildConfig({
 })
 ```
 
+Payload built-in localization must stay disabled. This plugin models translations as separate documents linked by metadata fields, so `localized: true` fields are not the intended model. If `config.localization` is enabled, `payloadMultilang()` throws during config setup.
+
 ## Plugin Options
 
 | Option                   | Type                                                 | Description                                                                                                            |
@@ -43,6 +45,20 @@ export default buildConfig({
 | `duplicateExcludeFields` | `string[]`                                           | Extra top-level fields to skip when a new translation duplicates source document data.                                 |
 | `disabled`               | `boolean`                                            | Returns the Payload config unchanged when true. Useful for temporary opt-out in specific environments.                 |
 
+## Content Model
+
+Translated collection entries are independent Payload documents. The plugin adds hidden metadata fields:
+
+```ts
+{
+  language: '_multilangLanguage',
+  group: '_multilangGroup',
+  meta: '_multilangMeta',
+}
+```
+
+Do not mark content fields as `localized: true` for this plugin model. Put translated text directly on each language document instead.
+
 ## Languages
 
 ```ts
@@ -144,7 +160,7 @@ payloadMultilang({
 })
 ```
 
-Read and update localized global values with `findGlobalByLanguage` and `updateGlobalByLanguage`.
+Read and update localized global values with `findGlobalByLanguageWithPayload`, `updateGlobalByLanguageWithPayload`, or helpers from `createMultilangHelpers()`.
 
 ## Custom Field Names
 
@@ -190,3 +206,18 @@ payloadMultilang({
 ```
 
 When using custom field names, pass the same names to helpers that accept `fieldNames` or `fieldName`.
+
+## Slug Uniqueness
+
+Because translations are separate documents, decide whether slugs are unique globally or per language.
+
+If every translated document has a different slug, a normal `unique: true` slug field works. If translations may share the same slug across languages, do not use global `unique: true`; enforce uniqueness with a compound database index or a custom validation rule scoped to:
+
+```ts
+{
+  _multilangLanguage: language,
+  slug,
+}
+```
+
+Use `localizedSlugQuery()` for common language + slug lookups in frontend routes.

package/docs/helpers.md

@@ -2,33 +2,52 @@
 
 Import helpers from `@roxxel/payload-multilang`.
 
+## Request-Scoped Helpers
+
+Use `WithPayload` helpers in endpoints, hooks, route handlers, and code running on behalf of a user.
+
 ```ts
 import {
-  findGlobalByLanguage,
   findGlobalByLanguageWithPayload,
-  getDocumentTranslation,
-  getDocumentTranslations,
-  getLanguages,
-  updateGlobalByLanguage,
+  getDocumentTranslationWithPayload,
+  getDocumentTranslationsWithPayload,
+  getGroupTranslationsWithPayload,
   updateGlobalByLanguageWithPayload,
-  withLanguage,
 } from '@roxxel/payload-multilang'
+
+const state = await getDocumentTranslationsWithPayload({
+  collection: 'posts',
+  id: post.id,
+  payload: req.payload,
+  req,
+  overrideAccess: false,
+})
 ```
 
-## `getLanguages`
+`overrideAccess` defaults to `true`, matching Payload Local API defaults. Set it to `false` and pass `req` when enforcing request user access.
+
+## `createMultilangHelpers`
 
-Returns the languages configured for the plugin.
+Use a tiny app-owned module for convenience helpers.
 
 ```ts
-const languages = await getLanguages()
+import { createMultilangHelpers } from '@roxxel/payload-multilang'
+import { getPayload } from 'payload'
+import config from '@payload-config'
+
+export const multilang = createMultilangHelpers({
+  getPayload: () => getPayload({ config }),
+})
 ```
 
-You can also pass known languages or a Payload config-like object.
+The factory returns:
 
 ```ts
-const languages = await getLanguages({
-  config: payload.config,
-})
+multilang.getLanguages()
+multilang.getDocumentTranslations(args)
+multilang.getDocumentTranslation(args)
+multilang.findGlobalByLanguage(args)
+multilang.updateGlobalByLanguage(args)
 ```
 
 ## `withLanguage`
@@ -36,6 +55,8 @@ const languages = await getLanguages({
 Adds a language constraint to a Payload `where` query.
 
 ```ts
+import { withLanguage } from '@roxxel/payload-multilang'
+
 const where = withLanguage({
   language: 'uk',
   where: {
@@ -65,37 +86,31 @@ Result:
 }
 ```
 
-Signature:
-
-```ts
-withLanguage(args: {
-  fieldName?: string
-  language: string
-  where?: Where
-}): Where
-```
-
 Use `fieldName` if you configured a custom collection language field.
 
-## `getDocumentTranslations`
+## Document Helpers
 
-Returns the source document and all linked translations for a localized collection document.
+`getDocumentTranslationsWithPayload` returns the source document and all linked translations for a localized collection document.
 
 ```ts
-const state = await getDocumentTranslations<Post>({
+const state = await getDocumentTranslationsWithPayload<Post>({
   collection: 'posts',
   id: post.id,
+  payload: req.payload,
+  req,
+  overrideAccess: false,
 })
 ```
 
-Signature:
+`getDocumentTranslationWithPayload` returns one target-language document.
 
 ```ts
-getDocumentTranslations<TDoc>(args: {
-  collection: CollectionSlug
-  fieldNames?: MultilangFieldNames
-  id: number | string
-}): Promise<TranslationState<TDoc>>
+const ukrainianPost = await getDocumentTranslationWithPayload<Post>({
+  collection: 'posts',
+  id: post.id,
+  language: 'uk',
+  payload: req.payload,
+})
 ```
 
 Return shape:
@@ -109,123 +124,82 @@ type TranslationState<TDoc = Record<string, unknown>> = {
 }
 ```
 
-## `getDocumentTranslation`
+## Global Helpers
 
-Returns one target-language document from the source document's translation group.
+Localized globals store one singleton document with one top-level tab per language. These helpers read or update one tab and return flat data for that language.
 
 ```ts
-const ukrainianPost = await getDocumentTranslation<Post>({
-  collection: 'posts',
-  id: post.id,
+const settings = await findGlobalByLanguageWithPayload<SiteSettings>({
+  slug: 'site-settings',
   language: 'uk',
+  payload: req.payload,
+  req,
+  overrideAccess: false,
 })
-```
-
-Signature:
-
-```ts
-getDocumentTranslation<TDoc>(args: {
-  collection: CollectionSlug
-  fieldNames?: MultilangFieldNames
-  id: number | string
-  language: string
-}): Promise<TDoc | undefined>
-```
-
-## `findGlobalByLanguage`
-
-Reads one language from a localized global and returns flat data for that language.
 
-```ts
-const settings = await findGlobalByLanguage<SiteSettings>({
+await updateGlobalByLanguageWithPayload<SiteSettings>({
   slug: 'site-settings',
   language: 'uk',
+  payload: req.payload,
+  data: {
+    title: 'Updated title',
+  },
 })
 ```
 
-Signature:
-
-```ts
-findGlobalByLanguage<TDoc>(args: {
-  depth?: number
-  language: string
-  slug: GlobalSlug
-}): Promise<TDoc>
-```
-
-## `updateGlobalByLanguage`
+## Constants
 
-Updates one language in a localized global.
+Default metadata field names are exported so apps do not need to hardcode them.
 
 ```ts
-const settings = await updateGlobalByLanguage<SiteSettings>({
-  slug: 'site-settings',
-  language: 'uk',
-  data: {
-    title: 'Ukrainian title',
-  },
-})
+import {
+  DEFAULT_FIELD_NAMES,
+  MULTILANG_GROUP_FIELD,
+  MULTILANG_LANGUAGE_FIELD,
+  MULTILANG_META_FIELD,
+} from '@roxxel/payload-multilang'
 ```
 
-Signature:
+Values:
 
 ```ts
-updateGlobalByLanguage<TDoc>(args: {
-  data: Record<string, unknown>
-  depth?: number
-  language: string
-  slug: GlobalSlug
-}): Promise<TDoc>
+{
+  language: '_multilangLanguage',
+  group: '_multilangGroup',
+  meta: '_multilangMeta',
+}
 ```
 
-The helper merges `data` into the selected language and preserves existing values in other languages.
-
-## Global Helpers With Payload
+## Preview Language Helper
 
-Use these variants when you already have a Payload instance or need request-aware access control.
+Use `getMultilangDocumentLanguage` in admin preview or livePreview URL builders. It checks unsaved form data first, then the persisted document.
 
 ```ts
-const settings = await findGlobalByLanguageWithPayload<SiteSettings>({
-  slug: 'site-settings',
-  language: 'uk',
-  overrideAccess: false,
-  payload: req.payload,
-  req,
-})
+import { getMultilangDocumentLanguage } from '@roxxel/payload-multilang'
 
-await updateGlobalByLanguageWithPayload<SiteSettings>({
-  slug: 'site-settings',
-  language: 'uk',
-  data: {
-    title: 'Updated title',
-  },
-  overrideAccess: false,
-  payload: req.payload,
-  req,
+const language = getMultilangDocumentLanguage({
+  data,
+  doc,
+  fallback: 'en',
 })
 ```
 
-Signatures:
+## Localized Slug Query
+
+`localizedSlugQuery` builds the common Local API query for language + slug + status.
 
 ```ts
-findGlobalByLanguageWithPayload<TDoc>(args: {
-  depth?: number
-  language: string
-  overrideAccess?: boolean
-  payload: Payload
-  req?: PayloadRequest
-  slug: GlobalSlug
-}): Promise<TDoc>
-
-updateGlobalByLanguageWithPayload<TDoc>(args: {
-  data: Record<string, unknown>
-  depth?: number
-  language: string
-  overrideAccess?: boolean
-  payload: Payload
-  req?: PayloadRequest
-  slug: GlobalSlug
-}): Promise<TDoc>
+import { localizedSlugQuery } from '@roxxel/payload-multilang'
+
+const { docs } = await payload.find({
+  collection: 'posts',
+  limit: 1,
+  ...localizedSlugQuery({
+    slug,
+    language: 'uk',
+    status: 'published',
+  }),
+})
 ```
 
-`overrideAccess` defaults to `true`. Set it to `false` when operating on behalf of a user.
+Use `status: 'draft'` to include `draft: true` and `_status = draft`, or `status: 'any'` to omit `_status`.

package/docs/usage.md

@@ -27,14 +27,69 @@ payloadMultilang({
 
 Editors can then choose the document language in the sidebar and create or connect translations from the collection list, document sidebar, or `Translations` edit tab.
 
+## App-Level Convenience Helpers
+
+Create one app-owned helper module when you want short helper calls in RSCs, route handlers, or other trusted server code.
+
+```ts
+// src/lib/multilang.ts
+import { createMultilangHelpers } from '@roxxel/payload-multilang'
+import { getPayload } from 'payload'
+import config from '@payload-config'
+
+export const multilang = createMultilangHelpers({
+  getPayload: () => getPayload({ config }),
+})
+```
+
+Then use it from your app:
+
+```tsx
+import { multilang } from '@/lib/multilang'
+
+export const LanguageSwitcher = async ({ id }: { id: string }) => {
+  const state = await multilang.getDocumentTranslations<{ id: string; slug?: string }>({
+    collection: 'posts',
+    id,
+  })
+
+  return (
+    <nav>
+      {Object.entries(state.translations).map(([language, doc]) => (
+        <a href={`/${language}/posts/${doc.slug || doc.id}`} key={language}>
+          {language.toUpperCase()}
+        </a>
+      ))}
+    </nav>
+  )
+}
+```
+
+## Request-Scoped Code
+
+Use `WithPayload` helpers when you already have `req.payload` or need user-scoped access control.
+
+```ts
+import { getDocumentTranslationsWithPayload } from '@roxxel/payload-multilang'
+
+export const getPostTranslations = async (req: PayloadRequest, id: string) =>
+  getDocumentTranslationsWithPayload({
+    collection: 'posts',
+    id,
+    payload: req.payload,
+    req,
+    overrideAccess: false,
+  })
+```
+
 ## Query Documents for One Language
 
 Use `withLanguage()` with the Local API.
 
 ```ts
+import { withLanguage } from '@roxxel/payload-multilang'
 import { getPayload } from 'payload'
 import config from '@payload-config'
-import { withLanguage } from '@roxxel/payload-multilang'
 
 export const getPosts = async (language: string) => {
   const payload = await getPayload({ config })
@@ -73,62 +128,64 @@ const where = withLanguage({
 })
 ```
 
-## Get Translations for a Document
+## Localized Slug Lookups
 
-Use `getDocumentTranslations()` when you have a document ID and need every linked translation.
+Use `localizedSlugQuery()` for the common language + slug + status lookup.
 
 ```ts
-import { getDocumentTranslations } from '@roxxel/payload-multilang'
+import { localizedSlugQuery } from '@roxxel/payload-multilang'
 
-const state = await getDocumentTranslations({
+const { docs } = await payload.find({
   collection: 'posts',
-  id: post.id,
+  limit: 1,
+  ...localizedSlugQuery({
+    slug: 'hello-world',
+    language: 'uk',
+    status: 'published',
+  }),
 })
-
-const english = state.translations.en
-const ukrainian = state.translations.uk
 ```
 
-The returned object is keyed by language code:
+For draft previews:
 
 ```ts
-type TranslationState<TDoc> = {
-  group?: string
-  language?: string
-  source?: TDoc
-  translations: Record<string, TDoc>
-}
-```
-
-Use `getDocumentTranslation()` when you only need one target language.
-
-```ts
-import { getDocumentTranslation } from '@roxxel/payload-multilang'
+const query = localizedSlugQuery({
+  slug,
+  language,
+  status: 'draft',
+})
 
-const ukrainianPost = await getDocumentTranslation({
+await payload.find({
   collection: 'posts',
-  id: post.id,
-  language: 'uk',
+  limit: 1,
+  ...query,
 })
 ```
 
-## Access Control in Server Code
+## Admin Preview URLs
 
-The document translation helpers resolve Payload from `@payload-config` and use the default Local API access behavior. When you need user-scoped collection reads, query with Payload directly and pass `overrideAccess: false`.
+Use `getMultilangDocumentLanguage()` to derive the selected language from unsaved form data first, then the saved document.
 
 ```ts
-const { docs } = await req.payload.find({
-  collection: 'posts',
-  overrideAccess: false,
-  req,
-  where: withLanguage({
-    language: 'uk',
-  }),
-})
+import { getMultilangDocumentLanguage } from '@roxxel/payload-multilang'
+
+export const Posts = {
+  slug: 'posts',
+  admin: {
+    preview: ({ data, doc }) => {
+      const language = getMultilangDocumentLanguage({
+        data,
+        doc,
+        fallback: 'en',
+      })
+
+      return `/${language}/posts/${data?.slug || doc?.slug}`
+    },
+  },
+  fields: [],
+}
 ```
 
-Use the global `WithPayload` helpers when you need request-aware access control for localized globals.
-
 ## Enable a Global
 
 Add the global slug to the plugin config.
@@ -142,44 +199,38 @@ payloadMultilang({
 })
 ```
 
-Then read one language as flat data:
+Read one language as flat data:
 
 ```ts
-import { findGlobalByLanguage } from '@roxxel/payload-multilang'
-
-const settings = await findGlobalByLanguage({
+const settings = await multilang.findGlobalByLanguage({
   slug: 'site-settings',
   language: 'uk',
 })
-
-console.log(settings.title)
 ```
 
-Update one language without replacing other language values:
+In request-scoped code:
 
 ```ts
-import { updateGlobalByLanguage } from '@roxxel/payload-multilang'
+import { findGlobalByLanguageWithPayload } from '@roxxel/payload-multilang'
 
-await updateGlobalByLanguage({
+const settings = await findGlobalByLanguageWithPayload({
   slug: 'site-settings',
   language: 'uk',
-  data: {
-    title: 'Ukrainian title',
-  },
+  payload: req.payload,
+  req,
+  overrideAccess: false,
 })
 ```
 
-In request-scoped code:
+Update one language without replacing other language values:
 
 ```ts
-import { findGlobalByLanguageWithPayload } from '@roxxel/payload-multilang'
-
-const settings = await findGlobalByLanguageWithPayload({
+await multilang.updateGlobalByLanguage({
   slug: 'site-settings',
   language: 'uk',
-  overrideAccess: false,
-  payload: req.payload,
-  req,
+  data: {
+    title: 'Ukrainian title',
+  },
 })
 ```
 
@@ -228,38 +279,6 @@ payloadMultilang({
 })
 ```
 
-## Build Language Switchers
-
-Use `getDocumentTranslations()` to render links to available translations.
-
-```tsx
-import { getDocumentTranslations } from '@roxxel/payload-multilang'
-
-export const LanguageSwitcher = async ({ collection, id }: { collection: 'posts'; id: string }) => {
-  type PostLink = {
-    id?: number | string
-    slug?: string
-  }
-
-  const state = await getDocumentTranslations<PostLink>({
-    collection,
-    id,
-  })
-
-  return (
-    <nav>
-      {Object.entries(state.translations).map(([language, doc]) => (
-        <a href={`/${language}/posts/${doc.slug || doc.id}`} key={language}>
-          {language.toUpperCase()}
-        </a>
-      ))}
-    </nav>
-  )
-}
-```
-
-Adjust the URL shape to match your frontend routing.
-
 ## Generate Types
 
 After enabling collections, globals, or changing field names, regenerate Payload types.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roxxel/payload-multilang",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Polylang-style document localization for Payload CMS",
   "license": "MIT",
   "repository": {

package/dist/payload-config.d.js

@@ -1,2 +0,0 @@
-
-//# sourceMappingURL=payload-config.d.js.map

package/dist/payload-config.d.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/payload-config.d.ts"],"names":[],"mappings":""}