@localazy/strapi-plugin 1.4.0 → 1.7.0

package/dist/server/src/bootstrap.d.ts

@@ -1,5 +1,5 @@
 import type { Core } from '@strapi/strapi';
 declare const bootstrap: ({ strapi }: {
     strapi: Core.Strapi;
-}) => void;
+}) => Promise<void>;
 export default bootstrap;

package/dist/server/src/constants/permissions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * UIDs as Strapi sees them after `pluginName` is prepended by the action provider.
+ * Use these to reference permissions from route policies, admin menu/settings links
+ * and `useRBAC` calls. Renaming any UID is a breaking change for existing role grants
+ * — bumping a minor version is not enough.
+ */
+export declare const PERMISSION_UIDS: {
+    readonly READ: `plugin::${string}.read`;
+    readonly TRANSFER: `plugin::${string}.transfer`;
+    readonly SETTINGS_READ: `plugin::${string}.settings.read`;
+    readonly SETTINGS_UPDATE: `plugin::${string}.settings.update`;
+};
+export type PermissionUid = (typeof PERMISSION_UIDS)[keyof typeof PERMISSION_UIDS];
+type ActionRecord = {
+    section: 'plugins';
+    subCategory: string;
+    pluginName: string;
+    displayName: string;
+    uid: string;
+};
+/**
+ * Actions registered with `strapi.service('admin::permission').actionProvider.registerMany`
+ * during bootstrap. `pluginName` is prepended as `plugin::<pluginName>.` so the resulting
+ * UIDs become the ones in `PERMISSION_UIDS` above.
+ *
+ * All four actions live under `section: 'plugins'` so they appear together in the
+ * role editor's Plugins tab under "Localazy", grouped by `subCategory`. A previous
+ * split (settings-section for the two settings.* actions) caused them to land in a
+ * different tab — admins inspecting Plugins → Localazy only saw Read + Transfer and
+ * thought the other two were missing.
+ *
+ * Strapi's @strapi/admin yup validator (a) rejects `category` on `plugins`-section
+ * entries — `category` is only valid in `settings` section — and (b) allows
+ * `subCategory` on both `plugins` and `settings`. So we use `subCategory` alone for
+ * grouping here.
+ */
+export declare const LOCALAZY_RBAC_ACTIONS: ActionRecord[];
+export {};

package/dist/server/src/controllers/index.d.ts

@@ -35,6 +35,7 @@ declare const _default: {
         updateContentTransferSetup(ctx: any): Promise<void>;
         getPluginSettings(ctx: any): Promise<void>;
         updatePluginSettings(ctx: any): Promise<void>;
+        updatePluginSettingsUiPrefs(ctx: any): Promise<void>;
         getSyncCursor(ctx: any): Promise<void>;
     };
     LocalazyTransferController: ({ strapi }: {

package/dist/server/src/controllers/plugin-settings-controller.d.ts

@@ -6,6 +6,7 @@ declare const PluginSettingsController: ({ strapi: _strapi }: {
     updateContentTransferSetup(ctx: any): Promise<void>;
     getPluginSettings(ctx: any): Promise<void>;
     updatePluginSettings(ctx: any): Promise<void>;
+    updatePluginSettingsUiPrefs(ctx: any): Promise<void>;
     getSyncCursor(ctx: any): Promise<void>;
 };
 export default PluginSettingsController;

package/dist/server/src/core/index.d.ts

@@ -18,9 +18,10 @@ export declare const getLocalazyTransferUploadService: () => {
     }): Promise<void>;
 };
 export declare const getLocalazyTransferDownloadService: () => {
-    download({ notificationService, fullSync, }: {
+    download({ notificationService, fullSync, requestedUiLanguages, }: {
         notificationService: import("../services/helpers/job-notification-service").default;
         fullSync?: boolean;
+        requestedUiLanguages?: string[];
     }): Promise<void>;
 };
 export declare const getPluginSettingsService: () => {
@@ -31,6 +32,7 @@ export declare const getPluginSettingsService: () => {
     }>;
     getPluginSettings(): Promise<import("../db/model/plugin-settings").PluginSettings>;
     updatePluginSettings(settings: any): Promise<any>;
+    updatePluginSettingsUiPrefs(prefs: Partial<Pick<import("../db/model/plugin-settings").PluginSettings, "defaultRoute" | "activityLogsSort">>): Promise<import("../db/model/plugin-settings").PluginSettings>;
     getSyncCursor(): Promise<import("../db/model/sync-cursor").SyncCursor>;
     updateSyncCursor(cursor: import("../db/model/sync-cursor").SyncCursor): Promise<import("../db/model/sync-cursor").SyncCursor>;
 };

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

@@ -4,7 +4,7 @@ declare const _default: {
     }) => void;
     bootstrap: ({ strapi }: {
         strapi: import("@strapi/types/dist/core").Strapi;
-    }) => void;
+    }) => Promise<void>;
     destroy: ({ strapi: _strapi }: {
         strapi: import("@strapi/types/dist/core").Strapi;
     }) => void;
@@ -62,6 +62,7 @@ declare const _default: {
             updateContentTransferSetup(ctx: any): Promise<void>;
             getPluginSettings(ctx: any): Promise<void>;
             updatePluginSettings(ctx: any): Promise<void>;
+            updatePluginSettingsUiPrefs(ctx: any): Promise<void>;
             getSyncCursor(ctx: any): Promise<void>;
         };
         LocalazyTransferController: ({ strapi }: {
@@ -93,25 +94,71 @@ declare const _default: {
     };
     routes: {
         'content-api': {
-            routes: {
+            routes: ({
                 method: string;
                 path: string;
                 handler: string;
                 config: {
-                    policies: any[];
+                    policies: {
+                        name: string;
+                        config: {
+                            actions: `plugin::${string}.read`[];
+                        };
+                    }[];
                 };
-            }[];
+            } | {
+                method: string;
+                path: string;
+                handler: string;
+                config: {
+                    policies: {
+                        name: string;
+                        config: {
+                            actions: `plugin::${string}.settings.update`[];
+                        };
+                    }[];
+                };
+            })[];
         };
         admin: {
             type: string;
-            routes: {
+            routes: ({
                 method: string;
                 path: string;
                 handler: string;
                 config: {
-                    policies: any[];
+                    policies: {
+                        name: string;
+                        config: {
+                            actions: `plugin::${string}.read`[];
+                        };
+                    }[];
                 };
-            }[];
+            } | {
+                method: string;
+                path: string;
+                handler: string;
+                config: {
+                    policies: {
+                        name: string;
+                        config: {
+                            actions: `plugin::${string}.settings.update`[];
+                        };
+                    }[];
+                };
+            } | {
+                method: string;
+                path: string;
+                handler: string;
+                config: {
+                    policies: {
+                        name: string;
+                        config: {
+                            actions: `plugin::${string}.transfer`[];
+                        };
+                    }[];
+                };
+            })[];
         };
         LocalazyPublicTransferRoutes: {
             routes: {
@@ -163,6 +210,7 @@ declare const _default: {
             }>;
             getPluginSettings(): Promise<import("./db/model/plugin-settings").PluginSettings>;
             updatePluginSettings(settings: any): Promise<any>;
+            updatePluginSettingsUiPrefs(prefs: Partial<Pick<import("./db/model/plugin-settings").PluginSettings, "defaultRoute" | "activityLogsSort">>): Promise<import("./db/model/plugin-settings").PluginSettings>;
             getSyncCursor(): Promise<import("./db/model/sync-cursor").SyncCursor>;
             updateSyncCursor(cursor: import("./db/model/sync-cursor").SyncCursor): Promise<import("./db/model/sync-cursor").SyncCursor>;
         };
@@ -176,9 +224,10 @@ declare const _default: {
         LocalazyTransferDownloadService: ({ strapi }: {
             strapi: import("@strapi/types/dist/core").Strapi;
         }) => {
-            download({ notificationService, fullSync, }: {
+            download({ notificationService, fullSync, requestedUiLanguages, }: {
                 notificationService: import("./services/helpers/job-notification-service").default;
                 fullSync?: boolean;
+                requestedUiLanguages?: string[];
             }): Promise<void>;
         };
         StrapiI18nService: ({ strapi }: {

package/dist/server/src/routes/activity-logs-routes.d.ts

@@ -1,9 +1,26 @@
-declare const ActivityLogsRoutes: {
+declare const ActivityLogsRoutes: ({
     method: string;
     path: string;
     handler: string;
     config: {
-        policies: any[];
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.read`[];
+            };
+        }[];
     };
-}[];
+} | {
+    method: string;
+    path: string;
+    handler: string;
+    config: {
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.transfer`[];
+            };
+        }[];
+    };
+})[];
 export default ActivityLogsRoutes;

package/dist/server/src/routes/debug-bundle-routes.d.ts

@@ -3,7 +3,12 @@ declare const DebugBundleRoutes: {
     path: string;
     handler: string;
     config: {
-        policies: any[];
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.read`[];
+            };
+        }[];
     };
 }[];
 export default DebugBundleRoutes;

package/dist/server/src/routes/entry-exclusion-routes.d.ts

@@ -1,9 +1,26 @@
-declare const EntryExclusionRoutes: {
+declare const EntryExclusionRoutes: ({
     method: string;
     path: string;
     handler: string;
     config: {
-        policies: any[];
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.read`[];
+            };
+        }[];
     };
-}[];
+} | {
+    method: string;
+    path: string;
+    handler: string;
+    config: {
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.transfer`[];
+            };
+        }[];
+    };
+})[];
 export default EntryExclusionRoutes;

package/dist/server/src/routes/index.d.ts

@@ -1,24 +1,70 @@
 declare const _default: {
     'content-api': {
-        routes: {
+        routes: ({
             method: string;
             path: string;
             handler: string;
             config: {
-                policies: any[];
+                policies: {
+                    name: string;
+                    config: {
+                        actions: `plugin::${string}.read`[];
+                    };
+                }[];
             };
-        }[];
+        } | {
+            method: string;
+            path: string;
+            handler: string;
+            config: {
+                policies: {
+                    name: string;
+                    config: {
+                        actions: `plugin::${string}.settings.update`[];
+                    };
+                }[];
+            };
+        })[];
     };
     admin: {
         type: string;
-        routes: {
+        routes: ({
             method: string;
             path: string;
             handler: string;
             config: {
-                policies: any[];
+                policies: {
+                    name: string;
+                    config: {
+                        actions: `plugin::${string}.read`[];
+                    };
+                }[];
             };
-        }[];
+        } | {
+            method: string;
+            path: string;
+            handler: string;
+            config: {
+                policies: {
+                    name: string;
+                    config: {
+                        actions: `plugin::${string}.settings.update`[];
+                    };
+                }[];
+            };
+        } | {
+            method: string;
+            path: string;
+            handler: string;
+            config: {
+                policies: {
+                    name: string;
+                    config: {
+                        actions: `plugin::${string}.transfer`[];
+                    };
+                }[];
+            };
+        })[];
     };
     LocalazyPublicTransferRoutes: {
         routes: {

package/dist/server/src/routes/localazy-auth-routes.d.ts

@@ -3,7 +3,12 @@ declare const LocalazyAuthRoutes: {
     path: string;
     handler: string;
     config: {
-        policies: any[];
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.settings.update`[];
+            };
+        }[];
     };
 }[];
 export default LocalazyAuthRoutes;

package/dist/server/src/routes/localazy-project-routes.d.ts

@@ -1,9 +1,26 @@
-declare const LocalazyProjectRoutes: {
+declare const LocalazyProjectRoutes: ({
     method: string;
     path: string;
     handler: string;
     config: {
-        policies: any[];
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.read`[];
+            };
+        }[];
     };
-}[];
+} | {
+    method: string;
+    path: string;
+    handler: string;
+    config: {
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.settings.update`[];
+            };
+        }[];
+    };
+})[];
 export default LocalazyProjectRoutes;

package/dist/server/src/routes/localazy-transfer-routes.d.ts

@@ -3,7 +3,12 @@ declare const LocalazyTransferRoutes: {
     path: string;
     handler: string;
     config: {
-        policies: any[];
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.transfer`[];
+            };
+        }[];
     };
 }[];
 export default LocalazyTransferRoutes;

package/dist/server/src/routes/localazy-user-routes.d.ts

@@ -1,9 +1,26 @@
-declare const LocalazyUserRoutes: {
+declare const LocalazyUserRoutes: ({
     method: string;
     path: string;
     handler: string;
     config: {
-        policies: any[];
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.read`[];
+            };
+        }[];
     };
-}[];
+} | {
+    method: string;
+    path: string;
+    handler: string;
+    config: {
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.settings.update`[];
+            };
+        }[];
+    };
+})[];
 export default LocalazyUserRoutes;

package/dist/server/src/routes/plugin-settings-routes.d.ts

@@ -1,9 +1,26 @@
-declare const PluginSettingsRoutes: {
+declare const PluginSettingsRoutes: ({
     method: string;
     path: string;
     handler: string;
     config: {
-        policies: any[];
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.read`[];
+            };
+        }[];
     };
-}[];
+} | {
+    method: string;
+    path: string;
+    handler: string;
+    config: {
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.settings.update`[];
+            };
+        }[];
+    };
+})[];
 export default PluginSettingsRoutes;

package/dist/server/src/routes/strapi-routes.d.ts

@@ -1,9 +1,26 @@
-declare const StrapiRoutes: {
+declare const StrapiRoutes: ({
     method: string;
     path: string;
     handler: string;
     config: {
-        policies: any[];
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.read`[];
+            };
+        }[];
     };
-}[];
+} | {
+    method: string;
+    path: string;
+    handler: string;
+    config: {
+        policies: {
+            name: string;
+            config: {
+                actions: `plugin::${string}.settings.update`[];
+            };
+        }[];
+    };
+})[];
 export default StrapiRoutes;

package/dist/server/src/services/index.d.ts

@@ -35,6 +35,7 @@ declare const _default: {
         }>;
         getPluginSettings(): Promise<import("../db/model/plugin-settings").PluginSettings>;
         updatePluginSettings(settings: any): Promise<any>;
+        updatePluginSettingsUiPrefs(prefs: Partial<Pick<import("../db/model/plugin-settings").PluginSettings, "defaultRoute" | "activityLogsSort">>): Promise<import("../db/model/plugin-settings").PluginSettings>;
         getSyncCursor(): Promise<import("../db/model/sync-cursor").SyncCursor>;
         updateSyncCursor(cursor: import("../db/model/sync-cursor").SyncCursor): Promise<import("../db/model/sync-cursor").SyncCursor>;
     };
@@ -48,9 +49,10 @@ declare const _default: {
     LocalazyTransferDownloadService: ({ strapi }: {
         strapi: import("@strapi/types/dist/core").Strapi;
     }) => {
-        download({ notificationService, fullSync, }: {
+        download({ notificationService, fullSync, requestedUiLanguages, }: {
             notificationService: import("./helpers/job-notification-service").default;
             fullSync?: boolean;
+            requestedUiLanguages?: string[];
         }): Promise<void>;
     };
     StrapiI18nService: ({ strapi }: {

package/dist/server/src/services/localazy-transfer-download-service.d.ts

@@ -3,9 +3,10 @@ import { JobNotificationServiceType } from './helpers/job-notification-service';
 declare const LocalazyTransferDownloadService: ({ strapi }: {
     strapi: Core.Strapi;
 }) => {
-    download({ notificationService, fullSync, }: {
+    download({ notificationService, fullSync, requestedUiLanguages, }: {
         notificationService: JobNotificationServiceType;
         fullSync?: boolean;
+        requestedUiLanguages?: string[];
     }): Promise<void>;
 };
 export type LocalazyTransferDownloadServiceReturnType = ReturnType<typeof LocalazyTransferDownloadService>;

package/dist/server/src/services/plugin-settings-service.d.ts

@@ -2,6 +2,9 @@ import { Core } from '@strapi/strapi';
 import { PluginSettings } from '../db/model/plugin-settings';
 import { SyncCursor } from '../db/model/sync-cursor';
 import { ContentTransferSetup } from '../models/plugin/content-transfer-setup';
+declare const UI_PREF_FIELDS: readonly ["defaultRoute", "activityLogsSort"];
+type UiPrefField = (typeof UI_PREF_FIELDS)[number];
+export type PluginSettingsUiPrefs = Partial<Pick<PluginSettings, UiPrefField>>;
 declare const PluginSettingsService: ({ strapi }: {
     strapi: Core.Strapi;
 }) => {
@@ -12,6 +15,7 @@ declare const PluginSettingsService: ({ strapi }: {
     }>;
     getPluginSettings(): Promise<PluginSettings>;
     updatePluginSettings(settings: any): Promise<any>;
+    updatePluginSettingsUiPrefs(prefs: PluginSettingsUiPrefs): Promise<PluginSettings>;
     getSyncCursor(): Promise<SyncCursor>;
     updateSyncCursor(cursor: SyncCursor): Promise<SyncCursor>;
 };

package/dist/server/src/utils/blocks-to-translatable.d.ts

@@ -0,0 +1,34 @@
+export declare const BLOCKS_ATTRIBUTE_TYPE = "blocks";
+type GetModel = (uid: string) => {
+    attributes?: Record<string, any>;
+} | undefined;
+/**
+ * Upload side. A Blocks value is a rich-text AST: text lives in `text` leaves, everything else
+ * (block types, headings, lists, links, marks, images, quotes, code blocks) is structure. We
+ * project each blocks field down to a skeleton that keeps only the translatable text leaves in
+ * their original positions, so the transfer pipeline emits ONE segment per text node with the
+ * formatting carried as structure — never as literal markup inside the string. The dropped
+ * structure is restored from the source AST on download (see `overlayBlocksTranslation`). Blocks
+ * nested inside components / dynamic zones are reached by walking the schema. The source entry is
+ * not mutated.
+ */
+export declare const projectBlocksFields: (entry: any, model: any, getModel: GetModel) => any;
+/**
+ * Reduce a blocks AST to a text-only skeleton: every node keeps only its `text` leaf and/or its
+ * (recursively projected) `children`. Structural nodes without text (e.g. images, dividers) become
+ * empty and contribute no segment. Positions are preserved so download can overlay by path.
+ */
+export declare const projectBlocksValue: (nodes: any) => any;
+/**
+ * Download side. Rebuild a full blocks AST for the target locale by cloning the source-locale AST
+ * and overlaying the translated text onto each text leaf at the matching position. All structure
+ * and formatting come from the source, so the result is always a document Strapi accepts, a
+ * translation identical to the source round-trips byte-identically, and text nodes left
+ * untranslated fall back to the source text. `translated` is the per-node text skeleton
+ * reconstructed from the downloaded keys (an array, or an object keyed by numeric position).
+ *
+ * Returns `undefined` when there is no source AST to overlay onto (nothing safe to write), so the
+ * caller can skip the field instead of corrupting it.
+ */
+export declare const overlayBlocksTranslation: (sourceAst: any, translated: any) => any[] | undefined;
+export {};

package/dist/server/src/utils/model-utils.d.ts

@@ -3,5 +3,6 @@ declare const isComponent: (attributeObj: any) => boolean;
 declare const isDynamicZone: (attributeObj: any) => boolean;
 declare const isRepeatable: (attributeObj: any) => boolean;
 declare const isRelation: (attributeObj: any) => boolean;
+declare const isBlocks: (attributeObj: any) => boolean;
 declare const findModel: (models: any, uid: any) => any;
-export { getAttribute, isComponent, isDynamicZone, isRepeatable, isRelation, findModel };
+export { getAttribute, isComponent, isDynamicZone, isRepeatable, isRelation, isBlocks, findModel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localazy/strapi-plugin",
-  "version": "1.4.0",
+  "version": "1.7.0",
   "description": "The official Strapi Plugin by Localazy.",
   "keywords": [
     "strapi",