@seshuk/payload-plugin-openapi 0.1.0 → 0.2.1

package/dist/spec/paths/collections.js

@@ -1,8 +1,8 @@
 import { makeT } from "../../translations/index.js";
-import { ERRORS, SECURITY_SCHEME_NAME, errorResponses, isOpenToPublic, jsonOk, uploadRequestBody } from "../components.js";
+import { ERRORS, errorResponses, jsonOk, jsonResponse, uploadRequestBody } from "../components.js";
 import { createSchemaName, listSchemaName, refTo, schemaName, updateSchemaName } from "../names.js";
-import { buildListParams, buildParamSchemas, commonReadParams } from "../params.js";
-const buildCollectionPaths = ({ collection, ctx })=>{
+import { buildListParams, buildParamSchemas, commonReadParams, writeParams } from "../params.js";
+const buildCollectionPaths = ({ collection, ctx, security = {} })=>{
     const t = makeT(ctx.i18n);
     const name = schemaName(collection.slug);
     const base = `${ctx.apiRoute}/${collection.slug}`;
@@ -19,11 +19,7 @@ const buildCollectionPaths = ({ collection, ctx })=>{
         $ref: refTo(updateSchemaName(name))
     };
     const idType = 'number' === ctx.defaultIDType ? 'integer' : 'string';
-    const secured = isOpenToPublic(collection.access?.read) ? void 0 : [
-        {
-            [SECURITY_SCHEME_NAME]: []
-        }
-    ];
+    const { read: secRead, create: secCreate, update: secUpdate, delete: secDelete } = security;
     const allowBulk = true !== collection.disableBulkEdit;
     const allowDuplicate = true !== collection.disableDuplicate;
     const paramSchemas = buildParamSchemas({
@@ -66,7 +62,7 @@ const buildCollectionPaths = ({ collection, ctx })=>{
         ...errorResponses(ERRORS.read, t)
     };
     const createResponse = {
-        ...jsonOk(t('collectionCreated'), mutationSchema),
+        201: jsonResponse(t('collectionCreated'), mutationSchema),
         ...errorResponses(ERRORS.create, t)
     };
     const updateResponse = {
@@ -122,34 +118,51 @@ const buildCollectionPaths = ({ collection, ctx })=>{
         }),
         ...errorResponses(ERRORS.list, t)
     };
-    const whereParameter = buildListParams({
+    const listParams = buildListParams({
         base: name,
         fields: collection.fields,
         ctx,
         refs
-    }).find((p)=>'where' === p.name);
-    const bulkParams = whereParameter ? [
-        whereParameter
-    ] : [];
+    });
+    const bulkParams = listParams.filter((p)=>'where' === p.name);
+    const bulkUpdateParams = listParams.filter((p)=>[
+            'limit',
+            'sort',
+            'where'
+        ].includes(p.name));
+    const write = (operation)=>writeParams({
+            base: name,
+            entity: collection,
+            ctx,
+            refs,
+            operation
+        });
+    const deleteParams = write('delete');
     const bulkOps = allowBulk ? {
         patch: {
             tags: [
                 name
             ],
             operationId: `update${name}`,
-            parameters: bulkParams,
+            parameters: [
+                ...bulkUpdateParams,
+                ...write('update')
+            ],
             requestBody: requestBody(updateRef, false),
             responses: bulkUpdateResponse,
-            security: secured
+            security: secUpdate
         },
         delete: {
             tags: [
                 name
             ],
             operationId: `delete${name}`,
-            parameters: bulkParams,
+            parameters: [
+                ...bulkParams,
+                ...deleteParams
+            ],
             responses: bulkDeleteResponse,
-            security: secured
+            security: secDelete
         }
     } : {};
     const paths = {
@@ -166,16 +179,17 @@ const buildCollectionPaths = ({ collection, ctx })=>{
                     refs
                 }),
                 responses: listResponse,
-                security: secured
+                security: secRead
             },
             post: {
                 tags: [
                     name
                 ],
                 operationId: `create${name}`,
+                parameters: write('create'),
                 requestBody: requestBody(createRef, fileRequiredOnCreate),
                 responses: createResponse,
-                security: secured
+                security: secCreate
             },
             ...bulkOps
         },
@@ -187,7 +201,7 @@ const buildCollectionPaths = ({ collection, ctx })=>{
                 operationId: `count${name}`,
                 parameters: bulkParams,
                 responses: countResponse,
-                security: secured
+                security: secRead
             }
         },
         [`${base}/{id}`]: {
@@ -212,24 +226,26 @@ const buildCollectionPaths = ({ collection, ctx })=>{
                     refs
                 }),
                 responses: findByIdResponse,
-                security: secured
+                security: secRead
             },
             patch: {
                 tags: [
                     name
                 ],
                 operationId: `update${name}ById`,
+                parameters: write('updateByID'),
                 requestBody: requestBody(updateRef, false),
                 responses: updateResponse,
-                security: secured
+                security: secUpdate
             },
             delete: {
                 tags: [
                     name
                 ],
                 operationId: `delete${name}ById`,
+                parameters: deleteParams,
                 responses: deleteResponse,
-                security: secured
+                security: secDelete
             }
         }
     };
@@ -249,11 +265,12 @@ const buildCollectionPaths = ({ collection, ctx })=>{
                 name
             ],
             operationId: `duplicate${name}`,
+            parameters: write('duplicate'),
             responses: {
                 ...jsonOk(t('collectionDuplicated'), mutationSchema),
                 ...errorResponses(ERRORS.create, t)
             },
-            security: secured
+            security: secCreate
         }
     };
     return paths;

package/dist/spec/paths/globals.d.ts

@@ -1,7 +1,9 @@
 import type { SanitizedGlobalConfig } from 'payload';
 import type { PathsObject } from '@scalar/openapi-types/3.2';
 import type { BuildContext } from '../../types.js';
-export declare const buildGlobalPaths: ({ global, ctx, }: {
+import type { EntitySecurity } from '../security.js';
+export declare const buildGlobalPaths: ({ global, ctx, security, }: {
     global: SanitizedGlobalConfig;
     ctx: BuildContext;
+    security?: EntitySecurity;
 }) => PathsObject;

package/dist/spec/paths/globals.js

@@ -1,8 +1,8 @@
 import { makeT } from "../../translations/index.js";
-import { ERRORS, SECURITY_SCHEME_NAME, errorResponses, isOpenToPublic, jsonOk } from "../components.js";
+import { ERRORS, errorResponses, jsonOk } from "../components.js";
 import { globalSchemaName, refTo, updateSchemaName } from "../names.js";
-import { buildParamSchemas, commonReadParams } from "../params.js";
-const buildGlobalPaths = ({ global, ctx })=>{
+import { buildParamSchemas, commonReadParams, writeParams } from "../params.js";
+const buildGlobalPaths = ({ global, ctx, security = {} })=>{
     const t = makeT(ctx.i18n);
     const name = globalSchemaName(global.slug);
     const docRef = {
@@ -11,11 +11,7 @@ const buildGlobalPaths = ({ global, ctx })=>{
     const updateRef = {
         $ref: refTo(updateSchemaName(name))
     };
-    const secured = isOpenToPublic(global.access?.read) ? void 0 : [
-        {
-            [SECURITY_SCHEME_NAME]: []
-        }
-    ];
+    const { read: secRead, update: secUpdate } = security;
     const paramSchemas = buildParamSchemas({
         fields: global.fields,
         ctx
@@ -25,7 +21,6 @@ const buildGlobalPaths = ({ global, ctx })=>{
         populate: Boolean(paramSchemas.populate),
         joins: Boolean(paramSchemas.joins)
     };
-    const okDoc = jsonOk(t('globalDoc'), docRef);
     return {
         [`${ctx.apiRoute}/globals/${global.slug}`]: {
             get: {
@@ -39,16 +34,23 @@ const buildGlobalPaths = ({ global, ctx })=>{
                     refs
                 }),
                 responses: {
-                    ...okDoc,
+                    ...jsonOk(t('globalDoc'), docRef),
                     ...errorResponses(ERRORS.globalRead, t)
                 },
-                security: secured
+                security: secRead
             },
             post: {
                 tags: [
                     name
                 ],
                 operationId: `update${name}`,
+                parameters: writeParams({
+                    base: name,
+                    entity: global,
+                    ctx,
+                    refs,
+                    operation: 'globalUpdate'
+                }),
                 requestBody: {
                     content: {
                         'application/json': {
@@ -57,10 +59,18 @@ const buildGlobalPaths = ({ global, ctx })=>{
                     }
                 },
                 responses: {
-                    ...okDoc,
+                    ...jsonOk(t('globalDoc'), {
+                        type: 'object',
+                        properties: {
+                            message: {
+                                type: 'string'
+                            },
+                            result: docRef
+                        }
+                    }),
                     ...errorResponses(ERRORS.globalUpdate, t)
                 },
-                security: secured
+                security: secUpdate
             }
         }
     };

package/dist/spec/paths/versions.d.ts

@@ -9,10 +9,11 @@ export declare const versionComponentSchemas: ({ docBase, base, idType, }: {
     base: string;
     idType: IDType;
 }) => VersionSchemas;
-export declare const buildVersionPaths: ({ entity, pathBase, ctx, schemaBase, nestedTags, }: {
+export declare const buildVersionPaths: ({ entity, pathBase, ctx, schemaBase, nestedTags, global, }: {
     entity: Entity;
     pathBase: string;
     ctx: BuildContext;
     schemaBase?: string;
     nestedTags: boolean;
+    global?: boolean;
 }) => PathsObject;

package/dist/spec/paths/versions.js

@@ -141,7 +141,7 @@ const listVersionParams = ({ base, ctx, refs })=>{
         }
     ];
 };
-const buildVersionPaths = ({ entity, pathBase, ctx, schemaBase, nestedTags })=>{
+const buildVersionPaths = ({ entity, pathBase, ctx, schemaBase, nestedTags, global = false })=>{
     if (!entity.versions) return {};
     const t = makeT(ctx.i18n);
     const name = schemaBase ?? schemaName(entity.slug);
@@ -165,7 +165,18 @@ const buildVersionPaths = ({ entity, pathBase, ctx, schemaBase, nestedTags })=>{
             type: 'number' === ctx.defaultIDType ? 'integer' : 'string'
         }
     };
-    const restoreResponse = {
+    const message = {
+        type: 'string'
+    };
+    const restoreResponse = global ? {
+        type: 'object',
+        properties: {
+            message,
+            doc: {
+                $ref: refTo(name)
+            }
+        }
+    } : {
         allOf: [
             {
                 $ref: refTo(name)
@@ -173,9 +184,7 @@ const buildVersionPaths = ({ entity, pathBase, ctx, schemaBase, nestedTags })=>{
             {
                 type: 'object',
                 properties: {
-                    message: {
-                        type: 'string'
-                    }
+                    message
                 }
             }
         ]

package/dist/spec/security.d.ts

@@ -0,0 +1,19 @@
+import type { Access } from 'payload';
+import type { PathsObject, SecurityRequirementObject } from '@scalar/openapi-types/3.2';
+import type { Entity, EntityKind, EntityOperation, OperationContext } from '../types.js';
+export type EntitySecurity = Partial<Record<EntityOperation, SecurityRequirementObject[] | undefined>>;
+export declare const evaluateAccess: (access: Access | undefined, opts?: {
+    locale?: string;
+    timeoutMs?: number;
+}) => Promise<boolean>;
+export declare const resolveEntitySecurity: ({ entity, operations, locale, }: {
+    entity: Entity;
+    operations: EntityOperation[];
+    locale?: string;
+}) => Promise<EntitySecurity>;
+export declare const applySecurityWhen: ({ paths, slug, kind, securityWhen, }: {
+    paths: PathsObject;
+    slug: string;
+    kind: EntityKind;
+    securityWhen?: (ctx: OperationContext) => boolean | undefined;
+}) => PathsObject;

package/dist/spec/security.js

@@ -0,0 +1,96 @@
+import { SECURITY_SCHEME_NAME } from "./components.js";
+const HTTP_METHODS = [
+    'get',
+    'post',
+    'patch',
+    'put',
+    'delete'
+];
+const securedRequirement = ()=>[
+        {
+            [SECURITY_SCHEME_NAME]: []
+        }
+    ];
+const withTimeout = async (promise, timeoutMs)=>{
+    let timer;
+    const guard = new Promise((resolve)=>{
+        timer = setTimeout(()=>resolve(false), timeoutMs);
+    });
+    try {
+        return await Promise.race([
+            promise.then((value)=>true === value, ()=>false),
+            guard
+        ]);
+    } finally{
+        if (timer) clearTimeout(timer);
+    }
+};
+const evaluateAccess = async (access, opts = {})=>{
+    if (!access) return false;
+    const { locale, timeoutMs = 250 } = opts;
+    const payloadTrap = new Proxy({}, {
+        get () {
+            throw new Error('req.payload accessed during build');
+        }
+    });
+    const req = {
+        user: null,
+        headers: new Headers(),
+        context: {},
+        locale,
+        payload: payloadTrap
+    };
+    try {
+        const result = access({
+            req
+        });
+        if (result && 'function' == typeof result.then) return await withTimeout(result, timeoutMs);
+        return true === result;
+    } catch  {
+        return false;
+    }
+};
+const readSecurityOverride = (entity)=>{
+    const meta = entity.custom?.openapi?.security;
+    if ('boolean' == typeof meta) return meta;
+    if (meta && 'object' == typeof meta) return meta;
+};
+const overrideFor = (override, op)=>{
+    if (void 0 === override) return;
+    if ('boolean' == typeof override) return override;
+    return override[op];
+};
+const resolveEntitySecurity = async ({ entity, operations, locale })=>{
+    const override = readSecurityOverride(entity);
+    const access = entity.access;
+    const out = {};
+    for (const op of operations){
+        const declared = overrideFor(override, op);
+        const isPublic = declared ?? await evaluateAccess(access?.[op], {
+            locale
+        });
+        out[op] = isPublic ? void 0 : securedRequirement();
+    }
+    return out;
+};
+const applySecurityWhen = ({ paths, slug, kind, securityWhen })=>{
+    if (!securityWhen) return paths;
+    for (const [path, item] of Object.entries(paths)){
+        if (!item) continue;
+        const ops = item;
+        for (const method of HTTP_METHODS){
+            const op = ops[method];
+            if (!op) continue;
+            const decision = securityWhen({
+                method,
+                path,
+                slug,
+                kind
+            });
+            if (true === decision) delete op.security;
+            else if (false === decision) op.security = securedRequirement();
+        }
+    }
+    return paths;
+};
+export { applySecurityWhen, evaluateAccess, resolveEntitySecurity };

package/dist/translations/locales/ar.js

@@ -5,6 +5,11 @@ const ar = {
         paramSortShort: 'الحقل المراد الترتيب حسبه؛ ضع البادئة `-` للترتيب التنازلي.',
         paramDraft: 'إرجاع نسخ المسودة.',
         paramTrash: 'تضمين المستندات المحذوفة.',
+        paramAutosave: 'الحفظ كحفظ تلقائي: تحديث آخر نسخة محفوظة تلقائيًا بدلًا من إضافة نسخة جديدة.',
+        paramPublishAllLocales: 'نشر كل اللغات، وليس لغة الطلب فقط.',
+        paramUnpublishAllLocales: 'إلغاء نشر كل اللغات وإعادة المستند إلى مسودة.',
+        paramOverrideLock: 'تجاهل القفل الذي يملكه مستخدم آخر. الافتراضي false.',
+        paramSelectedLocales: 'نسخ هذه اللغات فقط إلى النسخة المكررة. الافتراضي: كل اللغات.',
         paramFlattenLocales: 'مع `locale=all`، اضبط على false للإبقاء على الحقول المترجمة ككائنات لكل لغة. القيمة الافتراضية true.',
         paramLocale: 'اللغة المراد إرجاعها، أو `all` لكل اللغات. راجع قسم الترجمة في وصف الـ API.',
         paramFallbackLocale: 'اللغة الاحتياطية للقيم المترجمة المفقودة، أو `none` للتعطيل.',

package/dist/translations/locales/az.js

@@ -5,6 +5,11 @@ const az = {
         paramSortShort: 'Sıralanacaq sahə; azalan sıra üçün önünə `-` əlavə edin.',
         paramDraft: 'Qaralama versiyalarını qaytarın.',
         paramTrash: 'Zibilə atılmış sənədləri daxil edin.',
+        paramAutosave: 'Avtomatik yadda saxlama kimi saxlayın: yeni versiya əlavə etmək əvəzinə son avtomatik versiyanı yeniləyin.',
+        paramPublishAllLocales: 'Yalnız sorğu dilini deyil, bütün dilləri dərc edin.',
+        paramUnpublishAllLocales: 'Bütün dillərin dərcini ləğv edin və sənədi qaralamaya qaytarın.',
+        paramOverrideLock: 'Başqa istifadəçinin kilidinə məhəl qoymayın. Defolt false.',
+        paramSelectedLocales: 'Dublikata yalnız bu dilləri köçürün. Defolt: bütün dillər.',
         paramFlattenLocales: '`locale=all` ilə, lokallaşdırılmış sahələri hər lokal üzrə obyekt kimi saxlamaq üçün false təyin edin. Standart olaraq true.',
         paramLocale: 'Qaytarılacaq lokal, və ya hər lokal üçün `all`. API təsvirindəki Lokallaşdırma bölməsinə baxın.',
         paramFallbackLocale: 'Çatışmayan lokallaşdırılmış dəyərlər üçün geri dönüləcək lokal, və ya söndürmək üçün `none`.',

package/dist/translations/locales/bg.js

@@ -5,6 +5,11 @@ const bg = {
         paramSortShort: 'Поле за сортиране; добавете префикс `-` за низходящ ред.',
         paramDraft: 'Връщане на чернови версии.',
         paramTrash: 'Включване на документите в кошчето.',
+        paramAutosave: 'Запис като автоматично запазване: обновява последната автоматична версия, вместо да добавя нова.',
+        paramPublishAllLocales: 'Публикуване на всички езици, не само на езика на заявката.',
+        paramUnpublishAllLocales: 'Отмяна на публикуването на всички езици и връщане на документа в чернова.',
+        paramOverrideLock: 'Игнориране на заключване от друг потребител. По подразбиране false.',
+        paramSelectedLocales: 'Копиране само на тези езици в дубликата. По подразбиране: всички езици.',
         paramFlattenLocales: 'С `locale=all` задайте false, за да запазите локализираните полета като обекти по локал. По подразбиране true.',
         paramLocale: 'Локал за връщане или `all` за всеки локал. Вижте раздела Localization в описанието на API.',
         paramFallbackLocale: 'Локал, към който да се връща при липсващи локализирани стойности, или `none` за изключване.',

package/dist/translations/locales/bnBd.js

@@ -5,6 +5,11 @@ const bnBd = {
         paramSortShort: 'যে ফিল্ড দিয়ে সাজানো হবে; অবরোহী ক্রমের জন্য `-` উপসর্গ দিন।',
         paramDraft: 'ড্রাফট সংস্করণ ফেরত দিন।',
         paramTrash: 'ট্র্যাশে থাকা ডকুমেন্ট অন্তর্ভুক্ত করুন।',
+        paramAutosave: 'অটোসেভ হিসেবে সংরক্ষণ করুন: নতুন সংস্করণ যোগ না করে সর্বশেষ অটোসেভ সংস্করণ হালনাগাদ করুন।',
+        paramPublishAllLocales: 'শুধু অনুরোধের ভাষা নয়, সব ভাষা প্রকাশ করুন।',
+        paramUnpublishAllLocales: 'সব ভাষার প্রকাশ বাতিল করে ডকুমেন্টকে আবার ড্রাফট করুন।',
+        paramOverrideLock: 'অন্য ব্যবহারকারীর লক উপেক্ষা করুন। ডিফল্ট false।',
+        paramSelectedLocales: 'ডুপ্লিকেটে শুধু এই ভাষাগুলো কপি করুন। ডিফল্ট: সব ভাষা।',
         paramFlattenLocales: '`locale=all` এর সাথে, লোকালাইজড ফিল্ডগুলো প্রতি-লোকেল অবজেক্ট হিসেবে রাখতে false সেট করুন। ডিফল্ট true।',
         paramLocale: 'যে লোকেল ফেরত দিতে হবে, অথবা প্রতিটি লোকেলের জন্য `all`। API বিবরণের Localization অংশটি দেখুন।',
         paramFallbackLocale: 'অনুপস্থিত লোকালাইজড মানের জন্য যে লোকেলে ফিরে যাওয়া হবে, অথবা নিষ্ক্রিয় করতে `none`।',

package/dist/translations/locales/bnIn.js

@@ -5,6 +5,11 @@ const bnIn = {
         paramSortShort: 'যে ফিল্ড অনুযায়ী সাজানো হবে; অবরোহী ক্রমের জন্য `-` দিয়ে শুরু করুন।',
         paramDraft: 'খসড়া সংস্করণ ফেরত দিন।',
         paramTrash: 'আবর্জনায় থাকা নথি অন্তর্ভুক্ত করুন।',
+        paramAutosave: 'অটোসেভ হিসেবে সংরক্ষণ করুন: নতুন সংস্করণ যোগ না করে সর্বশেষ অটোসেভ সংস্করণ আপডেট করুন।',
+        paramPublishAllLocales: 'শুধু অনুরোধের ভাষা নয়, সব ভাষা প্রকাশ করুন।',
+        paramUnpublishAllLocales: 'সব ভাষার প্রকাশ বাতিল করে নথিটিকে আবার খসড়া করুন।',
+        paramOverrideLock: 'অন্য ব্যবহারকারীর লক উপেক্ষা করুন। ডিফল্ট false।',
+        paramSelectedLocales: 'প্রতিলিপিতে শুধু এই ভাষাগুলি কপি করুন। ডিফল্ট: সব ভাষা।',
         paramFlattenLocales: '`locale=all` সহ, স্থানীয়কৃত ফিল্ডগুলো প্রতি-লোকেল অবজেক্ট হিসেবে রাখতে false সেট করুন। ডিফল্ট true।',
         paramLocale: 'যে লোকেল ফেরত দেওয়া হবে, অথবা প্রতিটি লোকেলের জন্য `all`। API বিবরণে Localization বিভাগটি দেখুন।',
         paramFallbackLocale: 'অনুপস্থিত স্থানীয়কৃত মানের জন্য যে লোকেলে ফিরে যাওয়া হবে, অথবা নিষ্ক্রিয় করতে `none`।',

package/dist/translations/locales/ca.js

@@ -5,6 +5,11 @@ const ca = {
         paramSortShort: 'Camp pel qual ordenar; afegiu el prefix `-` per a ordre descendent.',
         paramDraft: "Retorna les versions d'esborrany.",
         paramTrash: 'Inclou els documents enviats a la paperera.',
+        paramAutosave: "Desa com a desat automàtic: actualitza l'última versió desada automàticament en lloc d'afegir-ne una de nova.",
+        paramPublishAllLocales: 'Publica tots els idiomes, no només el de la petició.',
+        paramUnpublishAllLocales: 'Despublica tots els idiomes i torna el document a esborrany.',
+        paramOverrideLock: "Ignora un bloqueig d'un altre usuari. Per defecte false.",
+        paramSelectedLocales: 'Copia només aquests idiomes al duplicat. Per defecte: tots els idiomes.',
         paramFlattenLocales: 'Amb `locale=all`, establiu-ho a false per mantenir els camps localitzats com a objectes per localització. Per defecte és true.',
         paramLocale: "Localització a retornar, o `all` per a totes les localitzacions. Vegeu la secció Localització a la descripció de l'API.",
         paramFallbackLocale: 'Localització de reserva per als valors localitzats que manquin, o `none` per desactivar-la.',

package/dist/translations/locales/cs.js

@@ -5,6 +5,11 @@ const cs = {
         paramSortShort: 'Pole pro řazení; pro sestupné řazení použijte předponu `-`.',
         paramDraft: 'Vrátit koncepty (draft verze).',
         paramTrash: 'Zahrnout dokumenty v koši.',
+        paramAutosave: 'Uložit jako automatické uložení: aktualizuje poslední automaticky uloženou verzi místo přidání nové.',
+        paramPublishAllLocales: 'Publikovat všechny jazyky, nejen jazyk požadavku.',
+        paramUnpublishAllLocales: 'Zrušit publikování všech jazyků a vrátit dokument do konceptu.',
+        paramOverrideLock: 'Ignorovat zámek jiného uživatele. Výchozí false.',
+        paramSelectedLocales: 'Zkopírovat do duplikátu jen tyto jazyky. Výchozí: všechny jazyky.',
         paramFlattenLocales: 'S `locale=all` nastavte false, aby lokalizovaná pole zůstala jako objekty po jednotlivých jazycích. Výchozí hodnota je true.',
         paramLocale: 'Jazyk, který se má vrátit, nebo `all` pro všechny jazyky. Viz sekce Lokalizace v popisu API.',
         paramFallbackLocale: 'Jazyk, na který se přejde u chybějících lokalizovaných hodnot, nebo `none` pro vypnutí.',

package/dist/translations/locales/da.js

@@ -5,6 +5,11 @@ const da = {
         paramSortShort: 'Felt at sortere efter; sæt `-` foran for faldende rækkefølge.',
         paramDraft: 'Returnér kladdeversioner.',
         paramTrash: 'Inkludér slettede dokumenter.',
+        paramAutosave: 'Gem som autogem: opdaterer den seneste autogemte version i stedet for at tilføje en ny.',
+        paramPublishAllLocales: 'Udgiv alle sprog, ikke kun forespørgslens sprog.',
+        paramUnpublishAllLocales: 'Afpublicér alle sprog og sæt dokumentet tilbage til kladde.',
+        paramOverrideLock: 'Ignorér en lås fra en anden bruger. Standard false.',
+        paramSelectedLocales: 'Kopiér kun disse sprog til dubletten. Standard: alle sprog.',
         paramFlattenLocales: 'Med `locale=all` skal du sætte false for at bevare lokaliserede felter som objekter pr. sprog. Standard er true.',
         paramLocale: 'Sprog der skal returneres, eller `all` for alle sprog. Se afsnittet Lokalisering i API-beskrivelsen.',
         paramFallbackLocale: 'Sprog der skal falde tilbage til for manglende lokaliserede værdier, eller `none` for at deaktivere.',

package/dist/translations/locales/de.js

@@ -5,6 +5,11 @@ const de = {
         paramSortShort: 'Feld, nach dem sortiert wird; für absteigende Sortierung mit `-` voranstellen.',
         paramDraft: 'Entwurfsversionen zurückgeben.',
         paramTrash: 'Gelöschte Dokumente einbeziehen.',
+        paramAutosave: 'Als Autosave speichern: aktualisiert die letzte Autosave-Version, statt eine neue anzulegen.',
+        paramPublishAllLocales: 'Alle Sprachen veröffentlichen, nicht nur die Sprache der Anfrage.',
+        paramUnpublishAllLocales: 'Die Veröffentlichung aller Sprachen aufheben und das Dokument wieder zum Entwurf machen.',
+        paramOverrideLock: 'Eine Sperre eines anderen Benutzers ignorieren. Standard false.',
+        paramSelectedLocales: 'Nur diese Sprachen in das Duplikat kopieren. Standard: alle Sprachen.',
         paramFlattenLocales: 'Mit `locale=all` auf false setzen, um lokalisierte Felder als Objekte je Sprache zu behalten. Standard ist true.',
         paramLocale: 'Zurückzugebende Sprache oder `all` für alle Sprachen. Siehe den Abschnitt zur Lokalisierung in der API-Beschreibung.',
         paramFallbackLocale: 'Sprache, auf die bei fehlenden lokalisierten Werten zurückgegriffen wird, oder `none` zum Deaktivieren.',

package/dist/translations/locales/en.js

@@ -5,6 +5,11 @@ const en = {
         paramSortShort: 'Field to sort by; prefix with `-` for descending.',
         paramDraft: 'Return draft versions.',
         paramTrash: 'Include trashed documents.',
+        paramAutosave: 'Save as an autosave: update the latest autosave version instead of adding a new one.',
+        paramPublishAllLocales: 'Publish every locale, not only the request locale.',
+        paramUnpublishAllLocales: 'Unpublish every locale and set the document back to draft.',
+        paramOverrideLock: 'Ignore a lock held by another user. Default false.',
+        paramSelectedLocales: 'Copy only these locales to the duplicate. Default: every locale.',
         paramFlattenLocales: 'With `locale=all`, set false to keep localized fields as per-locale objects. Default true.',
         paramLocale: "Locale to return, or `all` for every locale. See the Localization section in the API description.",
         paramFallbackLocale: 'Locale to fall back to for missing localized values, or `none` to disable.',

package/dist/translations/locales/es.js

@@ -5,6 +5,11 @@ const es = {
         paramSortShort: 'Campo por el que ordenar; antepón `-` para orden descendente.',
         paramDraft: 'Devolver versiones en borrador.',
         paramTrash: 'Incluir documentos en la papelera.',
+        paramAutosave: 'Guardar como autoguardado: actualiza la última versión autoguardada en lugar de añadir una nueva.',
+        paramPublishAllLocales: 'Publicar todos los idiomas, no solo el de la solicitud.',
+        paramUnpublishAllLocales: 'Despublicar todos los idiomas y devolver el documento a borrador.',
+        paramOverrideLock: 'Ignorar un bloqueo de otro usuario. Por defecto false.',
+        paramSelectedLocales: 'Copiar solo estos idiomas al duplicado. Por defecto: todos los idiomas.',
         paramFlattenLocales: 'Con `locale=all`, establécelo en false para mantener los campos localizados como objetos por idioma. Valor por defecto: true.',
         paramLocale: 'Idioma a devolver, o `all` para todos los idiomas. Consulta la sección de Localización en la descripción de la API.',
         paramFallbackLocale: 'Idioma de reserva para los valores localizados que falten, o `none` para desactivarlo.',

package/dist/translations/locales/et.js

@@ -5,6 +5,11 @@ const et = {
         paramSortShort: 'Väli, mille järgi sorteerida; kahanevaks järjestamiseks lisa ette `-`.',
         paramDraft: 'Tagasta mustandversioonid.',
         paramTrash: 'Kaasa prügikasti liigutatud dokumendid.',
+        paramAutosave: 'Salvesta automaatsalvestusena: uuendab viimast automaatselt salvestatud versiooni uue lisamise asemel.',
+        paramPublishAllLocales: 'Avalda kõik keeled, mitte ainult päringu keel.',
+        paramUnpublishAllLocales: 'Tühista kõigi keelte avaldamine ja muuda dokument tagasi mustandiks.',
+        paramOverrideLock: 'Eira teise kasutaja lukku. Vaikimisi false.',
+        paramSelectedLocales: 'Kopeeri duplikaati ainult need keeled. Vaikimisi: kõik keeled.',
         paramFlattenLocales: 'Väärtusega `locale=all` määra false, et hoida lokaliseeritud välju lokaadipõhiste objektidena. Vaikimisi true.',
         paramLocale: 'Tagastatav lokaat või `all` kõigi lokaatide jaoks. Vaata API kirjelduses jaotist Lokaliseerimine.',
         paramFallbackLocale: 'Lokaat, millele puuduvate lokaliseeritud väärtuste korral tagasi pöörduda, või `none` selle keelamiseks.',

package/dist/translations/locales/fa.js

@@ -5,6 +5,11 @@ const fa = {
         paramSortShort: 'فیلدی که بر اساس آن مرتب‌سازی شود؛ برای ترتیب نزولی پیشوند `-` بگذارید.',
         paramDraft: 'بازگرداندن نسخه‌های پیش‌نویس.',
         paramTrash: 'شامل اسناد حذف‌شده (در سطل زباله) شود.',
+        paramAutosave: 'ذخیره به‌صورت ذخیرهٔ خودکار: به‌جای افزودن نسخهٔ جدید، آخرین نسخهٔ ذخیرهٔ خودکار به‌روز می‌شود.',
+        paramPublishAllLocales: 'انتشار همهٔ زبان‌ها، نه فقط زبان درخواست.',
+        paramUnpublishAllLocales: 'لغو انتشار همهٔ زبان‌ها و بازگرداندن سند به پیش‌نویس.',
+        paramOverrideLock: 'نادیده گرفتن قفل کاربر دیگر. پیش‌فرض false.',
+        paramSelectedLocales: 'فقط این زبان‌ها در نسخهٔ تکراری کپی شوند. پیش‌فرض: همهٔ زبان‌ها.',
         paramFlattenLocales: 'با `locale=all`، مقدار false را تنظیم کنید تا فیلدهای محلی‌سازی‌شده به‌صورت اشیای جداگانه برای هر زبان نگه داشته شوند. مقدار پیش‌فرض true است.',
         paramLocale: 'زبانی که باید بازگردانده شود، یا `all` برای همه زبان‌ها. به بخش بومی‌سازی (Localization) در توضیحات API مراجعه کنید.',
         paramFallbackLocale: 'زبانی که در صورت نبودن مقادیر محلی‌سازی‌شده به آن بازگشت داده شود، یا `none` برای غیرفعال کردن.',

package/dist/translations/locales/fr.js

@@ -5,6 +5,11 @@ const fr = {
         paramSortShort: 'Champ de tri ; préfixez avec `-` pour un ordre décroissant.',
         paramDraft: 'Renvoie les versions brouillon.',
         paramTrash: 'Inclut les documents mis à la corbeille.',
+        paramAutosave: "Enregistrer en sauvegarde automatique : met à jour la dernière version enregistrée automatiquement au lieu d'en ajouter une.",
+        paramPublishAllLocales: 'Publier toutes les langues, pas seulement celle de la requête.',
+        paramUnpublishAllLocales: 'Dépublier toutes les langues et repasser le document en brouillon.',
+        paramOverrideLock: 'Ignorer un verrou détenu par un autre utilisateur. Par défaut false.',
+        paramSelectedLocales: 'Copier seulement ces langues dans le doublon. Par défaut : toutes les langues.',
         paramFlattenLocales: "Avec `locale=all`, définissez sur false pour conserver les champs localisés sous forme d'objets par locale. true par défaut.",
         paramLocale: "Locale \xe0 renvoyer, ou `all` pour toutes les locales. Voir la section Localisation dans la description de l'API.",
         paramFallbackLocale: 'Locale de repli pour les valeurs localisées manquantes, ou `none` pour désactiver.',

package/dist/translations/locales/he.js

@@ -5,6 +5,11 @@ const he = {
         paramSortShort: 'שדה למיון לפיו; הוסף קידומת `-` לסדר יורד.',
         paramDraft: 'החזרת גרסאות טיוטה.',
         paramTrash: 'כלול מסמכים שנמחקו (באשפה).',
+        paramAutosave: 'שמירה כשמירה אוטומטית: מעדכנת את גרסת השמירה האוטומטית האחרונה במקום להוסיף חדשה.',
+        paramPublishAllLocales: 'פרסום כל השפות, לא רק שפת הבקשה.',
+        paramUnpublishAllLocales: 'ביטול פרסום כל השפות והחזרת המסמך לטיוטה.',
+        paramOverrideLock: 'התעלמות מנעילה של משתמש אחר. ברירת מחדל false.',
+        paramSelectedLocales: 'העתקת שפות אלה בלבד לשכפול. ברירת מחדל: כל השפות.',
         paramFlattenLocales: 'עם `locale=all`, הגדר false כדי לשמור שדות מתורגמים כאובייקטים לכל לוקאל. ברירת המחדל true.',
         paramLocale: 'הלוקאל להחזרה, או `all` עבור כל הלוקאלים. ראה את סעיף הלוקליזציה בתיאור ה-API.',
         paramFallbackLocale: 'לוקאל לחזרה אחורה עבור ערכים מתורגמים חסרים, או `none` כדי להשבית.',