@localazy/strapi-plugin 0.1.5 → 0.1.8

package/README.md

@@ -1,4 +1,4 @@
-### The Official Strapi Localization Plugin by Localazy
+## The Official Strapi Localization Plugin by Localazy
 
 Strapi localization doesn't have to be a headache! Install the Strapi localization plugin and seamlessly translate your content into multiple languages with [Localazy](https://localazy.com).
 
@@ -9,15 +9,17 @@ Strapi localization doesn't have to be a headache! Install the Strapi localizati
 
 Learn more in the [Strapi + Localazy tutorial](https://localazy.com/blog/how-to-strapi-localization-with-localazy#getting-started-with-strapi-localization).
 
-### General information
-
-This repository contains all the code needed to run the Strapi Localization Plugin by Localazy.
+## Setup
 
 ### Install plugin via NPM
 
 The plugin is available on [NPM](https://www.npmjs.com/package/@localazy/strapi-plugin).
 You can also follow the installation commands located in your Strapi project Marketplace. This is the recommended approach.
 
+```
+npm install @localazy/strapi-plugin
+```
+
 ### Use plugin in a clean project locally
 
 Besides installing the plugin via `npm`, you can also use it in a project locally. Assuming you have a (clean) Strapi project set up, do:
@@ -43,12 +45,10 @@ module.exports = {
 
 5. Run the project. The plugin will be available in the admin.
 
-### Tests
+## Tests
 
 To run tests, run `npm run test` command. To watch tests, run `npm run test:watch` command.
 
-In case you have an access, you might also want to check the README file located in development project root for more information on tests debugging.
-
-### Support
+## Support
 - If you encounter any issues or have questions, please contact us at [team@localazy.com](mailto:team@localazy.com).
 - Join the [Localazy Discord](https://discord.gg/CAVhHrh) to discuss all things localization.

package/admin/src/modules/@common/components/PluginPageLoader/index.js

@@ -0,0 +1,22 @@
+import React from "react";
+import { Flex } from '@strapi/design-system/Flex';
+import { Loader } from "@strapi/design-system/Loader";
+import { useTranslation } from "react-i18next";
+
+import "../../../../i18n";
+
+function PluginPageLoader() {
+  const { t } = useTranslation();
+
+  return (
+    <Flex
+      marginTop={10}
+      alignItems="center"
+      justifyContent="center"
+    >
+      <Loader>{t("common.loading_content")}</Loader>
+    </Flex>
+  )
+}
+
+export default PluginPageLoader;

package/admin/src/modules/@common/services/product-analytics-service.js

@@ -0,0 +1,67 @@
+import AnalyticsService from "../../../plugins/analytics-service";
+
+export default class ProductAnalyticsService {
+  static async trackAppConnected(userId, project, params = {}) {
+    try {
+      const data = this.buildData(userId, "Strapi Connected", project, params);
+      await AnalyticsService.trackEvent(data.event, {
+        ...data.data,
+        userId,
+        category: "Project",
+      });
+    } catch (e) {
+      console.warn(e);
+    }
+  }
+
+  static async trackAppDisconnected(userId, project, params = {}) {
+    try {
+      const data = this.buildData(userId, "Strapi Disconnected", project, params);
+      await AnalyticsService.trackEvent(data.event, {
+        ...data.data,
+        userId,
+        category: "Project",
+      });
+    } catch (e) {
+      console.warn(e);
+    }
+  }
+
+  static async trackUploadToLocalazy(userId, project, params = {}) {
+    try {
+      const data = this.buildData(userId, "Strapi Upload", project, params);
+      await AnalyticsService.trackEvent(data.event, {
+        ...data.data,
+        userId,
+        category: "Project",
+      });
+    } catch (e) {
+      console.warn(e);
+    }
+  }
+
+  static async trackDownloadToStrapi(userId, project, params = {}) {
+    try {
+      const data = this.buildData(userId, "Strapi Download", project, params);
+      await AnalyticsService.trackEvent(data.event, {
+        ...data.data,
+        userId,
+        category: "Project",
+      });
+    } catch (e) {
+      console.warn(e);
+    }
+  }
+
+  static buildData(userId, event, project, params) {
+    return {
+      event,
+      data: {
+        "User Id": userId,
+        "Project Id": project.id,
+        "Project Name": project.name,
+        ...params,
+      },
+    };
+  }
+}

package/admin/src/modules/@common/utils/__tests__/iso-locales-utils.test.js

@@ -0,0 +1,102 @@
+const { isoStrapiToLocalazy, isoLocalazyToStrapi } = require("../iso-locales-utils");
+
+describe("iso-locales-utils.js", () => {
+  describe("transform Strapi ISO to Localazy ISO", () => {
+    it("should transform codes containing lang only", () => {
+      // setup
+      const input = ["en", "fr", "de", "es", "it", "ja", "ko", "pt", "ru", "zh"];
+
+      // execute
+      const output = input.map((item) => isoStrapiToLocalazy(item));
+
+      // verify
+      const expected = input;
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-region", () => {
+      // setup
+      const input = ["en-US", "fr-CA", "de-DE", "es-ES", "it-IT", "ja-JP", "ko-KR", "pt-BR", "ru-RU", "zh-CN"];
+
+      // execute
+      const output = input.map((item) => isoStrapiToLocalazy(item));
+
+      // verify
+      const expected = ["en_US", "fr_CA", "de_DE", "es_ES", "it_IT", "ja_JP", "ko_KR", "pt_BR", "ru_RU", "zh_CN"];
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-script", () => {
+      // setup
+      const input = ["en-Latn", "fr-Latn", "de-Latn", "es-Latn", "it-Latn", "ja-Latn", "ko-Latn", "pt-Latn", "ru-Latn", "zh-Latn"];
+
+      // execute
+      const output = input.map((item) => isoStrapiToLocalazy(item));
+
+      // verify
+      const expected = ["en#Latn", "fr#Latn", "de#Latn", "es#Latn", "it#Latn", "ja#Latn", "ko#Latn", "pt#Latn", "ru#Latn", "zh#Latn"];
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-script-region", () => {
+      // setup
+      const input = ["en-Latn-US", "fr-Latn-CA", "de-Latn-DE", "es-Latn-ES", "it-Latn-IT", "ja-Latn-JP", "ko-Latn-KR", "pt-Latn-BR", "ru-Latn-RU", "zh-Hant-CN"];
+
+      // execute
+      const output = input.map((item) => isoStrapiToLocalazy(item));
+
+      // verify
+      const expected = ["en_US#Latn", "fr_CA#Latn", "de_DE#Latn", "es_ES#Latn", "it_IT#Latn", "ja_JP#Latn", "ko_KR#Latn", "pt_BR#Latn", "ru_RU#Latn", "zh_CN#Hant"];
+      expect(output).toEqual(expected);
+    });
+  });
+
+  describe("transform Strapi ISO to Localazy ISO", () => {
+    it("should transform codes containing lang only", () => {
+      // setup
+      const input = ["en", "fr", "de", "es", "it", "ja", "ko", "pt", "ru", "zh"];
+
+      // execute
+      const output = input.map((item) => isoLocalazyToStrapi(item));
+
+      // verify
+      const expected = input;
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-region", () => {
+      // setup
+      const input = ["en_US", "fr_CA", "de_DE", "es_ES", "it_IT", "ja_JP", "ko_KR", "pt_BR", "ru_RU", "zh_CN"];
+
+      // execute
+      const output = input.map((item) => isoLocalazyToStrapi(item));
+
+      // verify
+      const expected = ["en-US", "fr-CA", "de-DE", "es-ES", "it-IT", "ja-JP", "ko-KR", "pt-BR", "ru-RU", "zh-CN"];
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-script", () => {
+      // setup
+      const input = ["en#Latn", "fr#Latn", "de#Latn", "es#Latn", "it#Latn", "ja#Latn", "ko#Latn", "pt#Latn", "ru#Latn", "zh#Latn"];
+
+      // execute
+      const output = input.map((item) => isoLocalazyToStrapi(item));
+
+      // verify
+      const expected = ["en-Latn", "fr-Latn", "de-Latn", "es-Latn", "it-Latn", "ja-Latn", "ko-Latn", "pt-Latn", "ru-Latn", "zh-Latn"];
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-script-region", () => {
+      // setup
+      const input = ["en_US#Latn", "fr_CA#Latn", "de_DE#Latn", "es_ES#Latn", "it_IT#Latn", "ja_JP#Latn", "ko_KR#Latn", "pt_BR#Latn", "ru_RU#Latn", "zh_CN#Hant"];
+
+      // execute
+      const output = input.map((item) => isoLocalazyToStrapi(item));
+      // verify
+      const expected = ["en-Latn-US", "fr-Latn-CA", "de-Latn-DE", "es-Latn-ES", "it-Latn-IT", "ja-Latn-JP", "ko-Latn-KR", "pt-Latn-BR", "ru-Latn-RU", "zh-Hant-CN"];
+      expect(output).toEqual(expected);
+    });
+  });
+});

package/admin/src/modules/@common/utils/format-number.js

@@ -0,0 +1 @@
+export default (value, options = undefined) => new Intl.NumberFormat("en-GB", options).format(value);

package/admin/src/modules/@common/utils/iso-locales-utils.js

@@ -3,7 +3,31 @@ export const isoStrapiToLocalazy = (isoStrapi) => {
     return null;
   }
 
-  return isoStrapi.replace("_", "-");
+  const split = isoStrapi.split("-");
+  const language = split[0];
+
+  const hasRegionAndScript = split.length === 3;
+
+  if (hasRegionAndScript) {
+    const script = split[1];
+    const region = split[2];
+
+    return `${language}_${region}#${script}`;
+  }
+
+  const hasPossiblyRegion = split.length === 2;
+
+  if (hasPossiblyRegion) {
+    const regionOrScript = split[1];
+
+    // is it script - the way Strapi resolves that
+    const isItRegion = regionOrScript.toUpperCase() === regionOrScript;
+
+    // it is region; otherwise it is script
+    return isItRegion ? `${language}_${regionOrScript}` : `${language}#${regionOrScript}`;
+  }
+
+  return isoStrapi.replace("-", "_");
 };
 
 export const isoLocalazyToStrapi = (isoLocalazy) => {
@@ -11,5 +35,24 @@ export const isoLocalazyToStrapi = (isoLocalazy) => {
     return null;
   }
 
-  return isoLocalazy.replace("-", "_");
+  const scriptIndex = isoLocalazy.indexOf("#");
+  const hasScript = scriptIndex > -1;
+
+  if (hasScript) {
+    const script = isoLocalazy.substring(scriptIndex + 1);
+    const isoLocalazyWithoutScript = isoLocalazy.substring(0, scriptIndex);
+    const split = isoLocalazyWithoutScript.split("_");
+    const language = split[0];
+    const region = split[1];
+
+    if (!region) {
+      return `${language}-${script}`;
+    }
+
+    const isoStrapi = `${language}-${script}-${region.toUpperCase()}`;
+
+    return isoStrapi;
+  }
+
+  return isoLocalazy.replace("_", "-");
 };

package/admin/src/pages/App/index.js

@@ -12,8 +12,8 @@ import { ThemeProvider } from "@strapi/design-system/ThemeProvider";
 import { lightTheme } from "@strapi/design-system/themes";
 import { Box } from "@strapi/design-system/Box";
 import { Layout } from "@strapi/design-system/Layout";
-import { Loader } from "@strapi/design-system/Loader";
 import { useTranslation } from "react-i18next";
+import Loader from "../../modules/@common/components/PluginPageLoader";
 import pluginId from "../../pluginId";
 import Download from "../Download";
 import Settings from "../Settings";

package/admin/src/pages/Download/index.js

@@ -5,11 +5,11 @@ import { Button } from "@strapi/design-system/Button";
 import DownloadIcon from "@strapi/icons/Download";
 import { Box } from "@strapi/design-system/Box";
 import { Alert } from "@strapi/design-system/Alert";
-import { Loader } from "@strapi/design-system/Loader";
 import { useTranslation } from "react-i18next";
 import { Flex } from '@strapi/design-system/Flex';
 import { Divider } from '@strapi/design-system/Divider';
 import { Typography } from "@strapi/design-system/Typography";
+import Loader from "../../modules/@common/components/PluginPageLoader";
 import LocalazyDownloadService from "../../modules/localazy-download/services/localazy-download-service";
 import areLocalesCompatible from "../../modules/@common/utils/are-locales-compatible";
 import hasModelChanged from "../../modules/plugin-settings/functions/has-model-changed";
@@ -17,6 +17,7 @@ import TransferReport from "../../modules/@common/components/TransferReport";
 import ReadDocsButton from "../../modules/localazy-upload/components/ReadDocsButton";
 import "../../i18n";
 import { getLocalazyIdentity } from "../../state/localazy-identity";
+import ProductAnalyticsService from "../../modules/@common/services/product-analytics-service";
 
 function Download(props) {
   const { t } = useTranslation();
@@ -44,6 +45,16 @@ function Download(props) {
     setIsDownloading(true);
     const result = await LocalazyDownloadService.download();
     setDownloadResult(result);
+
+    // track download
+    ProductAnalyticsService.trackDownloadToStrapi(
+      localazyIdentity.user.id,
+      localazyIdentity.project,
+      {
+        "Target Languages Codes": "all",
+      }
+    );
+
     setIsDownloading(false);
     setshowDownloadFinishedModal(true);
   };
@@ -115,7 +126,7 @@ function Download(props) {
             >
               <Divider />
             </Box>
-            <Box marginTop={4}>
+            <Box marginTop={2}>
               <Flex gap="2">
                 <Button variant="secondary" onClick={onTranslateInLocalazyClick}>
                   {t("download.translate_in_localazy")}

package/admin/src/pages/Login/index.js

@@ -6,19 +6,20 @@
 
 import React from "react";
 import PropTypes from "prop-types";
-import { Loader } from "@strapi/design-system/Loader";
 import { Link } from "@strapi/design-system/Link";
 import { useHistory } from "react-router-dom";
 import { useTranslation } from "react-i18next";
 import { HeaderLayout } from "@strapi/design-system/Layout";
 import { Box } from "@strapi/design-system/Box";
 import { Typography } from "@strapi/design-system/Typography";
+import Loader from "../../modules/@common/components/PluginPageLoader";
 import { setLocalazyIdentity } from "../../state/localazy-identity";
 import LocalazyUserService from "../../modules/user/services/localazy-user-service";
 import LoginButton from "../../modules/login/components/LoginButton";
 import redirectToPluginRoute, {
   PLUGIN_ROUTES,
 } from "../../modules/@common/utils/redirect-to-plugin-route";
+import ProductAnalyticsService from "../../modules/@common/services/product-analytics-service";
 
 import "../../i18n";
 
@@ -40,6 +41,12 @@ function Login(props) {
     setLocalazyIdentity(result);
 
     if (result.accessToken) {
+      // track user login
+      ProductAnalyticsService.trackAppConnected(
+        result.user.id,
+        result.project,
+      );
+
       redirectToPluginRoute(PLUGIN_ROUTES.DOWNLOAD, history);
     }
   };
@@ -49,11 +56,21 @@ function Login(props) {
       <HeaderLayout
         title={props.title}
         subtitle={props.subtitle}
-        as="h2"
+        as="h1"
       />
       {props.isLoading && (<Loader>{t("common.loading_content")}</Loader>)}
       {!props.isLoading && (
-        <Box paddingLeft={10}>
+        <Box
+          marginLeft={10}
+          marginRight={10}
+          background="neutral0"
+          paddingTop={6}
+          paddingRight={7}
+          paddingBottom={6}
+          paddingLeft={7}
+          hasRadius
+          shadow="tableShadow"
+        >
           <Box>
             <Typography variant="epsilon" textColor="neutral600">
               {t("common.localazy_plugin_description")}

package/admin/src/pages/Settings/index.js

@@ -1,12 +1,12 @@
 import React, { useEffect, useState } from "react";
 import PropTypes from "prop-types";
-import { Loader } from "@strapi/design-system/Loader";
 import { HeaderLayout } from "@strapi/design-system/Layout";
 import { Box } from "@strapi/design-system/Box";
 import { useHistory } from "react-router-dom";
 import { useTranslation } from "react-i18next";
 import { Grid } from '@strapi/design-system/Grid';
 import { Divider } from '@strapi/design-system/Divider';
+import Loader from "../../modules/@common/components/PluginPageLoader";
 import LogoutButton from "../../modules/login/components/LogoutButton";
 import redirectToPluginRoute, {
   PLUGIN_ROUTES,
@@ -16,6 +16,8 @@ import OverviewItem from "../../modules/settings/components/OverviewItem";
 import OverviewItemLink from "../../modules/settings/components/OverviewItemLink";
 import PrerequisitiesInfo from "../../modules/settings/components/PrerequisitiesInfo";
 import ProjectService from "../../modules/@common/services/project-service";
+import ProductAnalyticsService from "../../modules/@common/services/product-analytics-service";
+import formatNumber from "../../modules/@common/utils/format-number";
 
 import "../../i18n";
 
@@ -45,6 +47,12 @@ function Settings(props) {
    * On logout action
    */
   const onLoggedOut = () => {
+    // track user logout
+    ProductAnalyticsService.trackAppDisconnected(
+      localazyIdentity.user.id,
+      localazyIdentity.project,
+    );
+
     redirectToPluginRoute(PLUGIN_ROUTES.LOGIN, history);
   };
 
@@ -56,7 +64,9 @@ function Settings(props) {
         primaryAction={<LogoutButton onResultFetched={onLoggedOut} />}
         as="h2"
       />
-      {(props.isLoading || isLoading) && (<Loader>{t("common.loading_content")}</Loader>)}
+      {(props.isLoading || isLoading) && (
+        <Loader>{t("common.loading_content")}</Loader>
+      )}
       {!(props.isLoading || isLoading) && (
         <Box paddingRight={10} paddingLeft={10}>
           <Box
@@ -86,7 +96,7 @@ function Settings(props) {
               <OverviewItem
                 label={t("settings.remaining_organization_keys")}
                 value={
-                  connectedProject.organization.availableKeys - connectedProject.organization.usedKeys
+                  formatNumber(connectedProject.organization.availableKeys - connectedProject.organization.usedKeys)
                 }
               />
               <OverviewItemLink

package/admin/src/pages/Upload/index.js

@@ -9,7 +9,7 @@ import { Button } from "@strapi/design-system/Button";
 import UploadIcon from "@strapi/icons/Upload";
 import { Box } from "@strapi/design-system/Box";
 import { Alert } from "@strapi/design-system/Alert";
-import { Loader } from "@strapi/design-system/Loader";
+import Loader from "../../modules/@common/components/PluginPageLoader";
 import LocalazyUploadService from "../../modules/localazy-upload/services/localazy-upload-service";
 import areLocalesCompatible from "../../modules/@common/utils/are-locales-compatible";
 import { getStrapiDefaultLocale, getLocalazySourceLanguage } from "../../modules/@common/utils/get-default-locale";
@@ -21,6 +21,8 @@ import ReadDocsButton from "../../modules/localazy-upload/components/ReadDocsBut
 import redirectToPluginRoute, {
   PLUGIN_ROUTES,
 } from "../../modules/@common/utils/redirect-to-plugin-route";
+import { getLocalazyIdentity } from "../../state/localazy-identity";
+import ProductAnalyticsService from "../../modules/@common/services/product-analytics-service";
 
 import "../../i18n";
 
@@ -38,6 +40,7 @@ function Upload(props) {
   const [isUploading, setIsUploading] = useState(false);
   const [strapiDefaultLocale, setStrapiDefaultLocale] = useState(null);
   const [localazySourceLanguage, setLocalazySourceLanguage] = useState(null);
+  const [localazyIdentity] = getLocalazyIdentity();
 
   const onChangeSettingsClick = () => {
     redirectToPluginRoute(PLUGIN_ROUTES.CONTENT_TRANSFER_SETUP);
@@ -49,6 +52,16 @@ function Upload(props) {
     setIsUploading(true);
     const result = await LocalazyUploadService.upload();
     setUploadResult(result);
+
+    // track upload
+    ProductAnalyticsService.trackUploadToLocalazy(
+      localazyIdentity.user.id,
+      localazyIdentity.project,
+      {
+        "Source Language Code": localazySourceLanguage.code,
+      }
+    );
+
     setIsUploading(false);
     setShowUploadFinishedModal(true);
   };

package/admin/src/plugins/analytics-service.js

@@ -0,0 +1,14 @@
+import createPluginConnectorAxiosInstance from "../utils/createPluginConnectorAxiosInstance";
+
+const ANALYTICS_PATH = "/analytics";
+const axiosInstance = createPluginConnectorAxiosInstance();
+export default class AnalyticsService {
+  static async trackEvent(event, data) {
+    const result = await axiosInstance.post(`${ANALYTICS_PATH}/track`, {
+      event,
+      ...data,
+    });
+
+    return result.data;
+  }
+}

package/admin/src/utils/createPluginConnectorAxiosInstance.js

@@ -0,0 +1,45 @@
+/**
+ * axios with plugin connector config.
+ */
+
+import axios from "axios";
+import { config } from "../../../server";
+
+const BASE_PLUGIN_PATH = config.default.LOCALAZY_PLUGIN_CONNECTOR_API_URL;
+
+const createPluginConnectorAxiosInstance = (baseUrl = null) => {
+  if (baseUrl === null) {
+    baseUrl = `${BASE_PLUGIN_PATH}`;
+  }
+
+  const instance = axios.create({
+    baseURL: baseUrl,
+  });
+
+  instance.interceptors.request.use(
+    async (config) => {
+      config.headers = {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        // Strapi plugin id in terms of plugin connector
+        "X-Localazy-Plugin-Id": 1,
+      };
+
+      return config;
+    },
+    (error) => {
+      Promise.reject(error);
+    }
+  );
+
+  instance.interceptors.response.use(
+    (response) => response,
+    (error) => {
+      throw error;
+    }
+  );
+
+  return instance;
+};
+
+export default createPluginConnectorAxiosInstance;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localazy/strapi-plugin",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "description": "The official Strapi Plugin by Localazy.",
   "strapi": {
     "name": "localazy",
@@ -28,8 +28,6 @@
   },
   "dependencies": {
     "@localazy/ts-api": "^1.0.6",
-    "@strapi/design-system": "^1.0.0",
-    "@strapi/icons": "^1.0.0",
     "deep-keys": "^0.5.0",
     "i18next": "^21.6.13",
     "isomorphic-fetch": "^3.0.0",
@@ -41,7 +39,9 @@
     "styled-components": "^5.3.3"
   },
   "peerDependencies": {
-    "@strapi/strapi": "^4.0.0"
+    "@strapi/strapi": "^4.0.0",
+    "@strapi/design-system": "^1.0.0",
+    "@strapi/icons": "^1.0.0"
   },
   "devDependencies": {
     "@babel/plugin-transform-modules-commonjs": "^7.17.7",
@@ -52,8 +52,8 @@
     "jest": "^27.5.1"
   },
   "author": {
-    "name": "David Vaclavek",
-    "email": "david@localazy.com",
+    "name": "Localazy",
+    "email": "team@localazy.com",
     "url": "https://localazy.com"
   },
   "maintainers": [

package/server/config/development/index.js

@@ -2,8 +2,8 @@
 
 module.exports = {
   LOCALAZY_OAUTH_URL: "https://testing.localazy.com/oauth/authorize",
-  LOCALAZY_OAUTH_APP_CLIENT_ID: "18503917571895066465",
-  LOCALAZY_PLUGIN_CONNECTOR_API_URL: "http://localhost:3000",
+  LOCALAZY_OAUTH_APP_CLIENT_ID: "18503917571895066466",
+  LOCALAZY_PLUGIN_CONNECTOR_API_URL: "https://testing.localazy.com/plugin-connector",
   LOCALAZY_PUBLIC_API_URL: "https://testing.localazy.com/pubapi",
   LOCALAZY_PLUGIN_ID: "1",
   LOCALAZY_DEFAULT_FILE_NAME: "strapi.json",

package/server/config/index.js

@@ -1,15 +1,20 @@
 "use strict";
 
 // depending on the STRAPI_ADMIN_LOCALAZY_ENV, use the correct config
-const config =
-  process.env.STRAPI_ADMIN_LOCALAZY_ENV === "development"
-    ? require("./development/index")
-    : require("./production/index");
+let config = require("./production/index");
+
+if (process.env.STRAPI_ADMIN_LOCALAZY_ENV === "local") {
+  config = require("./local/index");
+}
+
+if (process.env.STRAPI_ADMIN_LOCALAZY_ENV === "development") {
+  config = require("./development/index");
+}
 
 module.exports = {
   default: {
     // Default plugin configuration, merged with the user configuration
     ...(config || {}),
   },
-  validator() {},
+  validator() { },
 };

package/server/config/local/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+module.exports = {
+  LOCALAZY_OAUTH_URL: "https://testing.localazy.com/oauth/authorize",
+  LOCALAZY_OAUTH_APP_CLIENT_ID: "18503917571895066465",
+  LOCALAZY_PLUGIN_CONNECTOR_API_URL: "http://localhost:3000",
+  LOCALAZY_PUBLIC_API_URL: "https://testing.localazy.com/pubapi",
+  LOCALAZY_PLUGIN_ID: "1",
+  LOCALAZY_DEFAULT_FILE_NAME: "strapi.json",
+  LOCALAZY_DEFAULT_FILE_PATH: "",
+  LOCALAZY_DEFAULT_FILE_EXTENSION: "json",
+  LOCALAZY_DEFAULT_LOCALE: "en",
+  LOCALAZY_API_USER_JWT_COOKIE_NAME: "LOCALAZY-API-USER-JWT",
+  LOCALAZY_API_USER_COOKIE_EXPIRATION: 7,
+};

package/server/controllers/localazy-transfer-controller.js

@@ -25,7 +25,9 @@ module.exports = {
       const messageReport = [];
 
       // Strapi Service
-      const StrapiService = strapi.plugin("localazy").service("strapiService");
+      const StrapiService = strapi
+        .plugin("localazy")
+        .service("strapiService");
 
       // Strapi i18n Service
       const StrapiI18nService = strapi

package/server/services/strapi-i18n-service.js

@@ -13,17 +13,18 @@ module.exports = ({ strapi }) => ({
   async createStrapiLocale(ctx, isoLocalazy) {
     try {
       const isoStrapi = isoLocalazyToStrapi(isoLocalazy);
-      const localeName = intlDisplayName(isoLocalazy);
+      let localeName = intlDisplayName(isoStrapi);
 
       if (!localeName || !isoStrapi) {
         throw new Error("Invalid locale");
       }
+      localeName = `${localeName} (${isoStrapi})`;
 
       const newLocaleCtx = { ...ctx };
       newLocaleCtx.request.body = {
         isDefault: false,
         code: isoStrapi,
-        name: localeName,
+        name: localeName.substring(0, 50), // limit name to 50 characters (given by Strapi)
       };
 
       await strapi
@@ -39,7 +40,6 @@ module.exports = ({ strapi }) => ({
   parseLocalazyKey(key) {
     const split = key.split(/\.|\[|\]/);
     const filteredSplit = split.filter((item) => item !== "");
-    // return split;
 
     return {
       uid: `${filteredSplit[0]}.${filteredSplit[1]}`,

package/server/utils/__tests__/iso-locales-utils.test.js

@@ -0,0 +1,104 @@
+"use strict";
+
+const { isoStrapiToLocalazy, isoLocalazyToStrapi } = require("../iso-locales-utils.js");
+
+describe("iso-locales-utils.js", () => {
+  describe("transform Strapi ISO to Localazy ISO", () => {
+    it("should transform codes containing lang only", () => {
+      // setup
+      const input = ["en", "fr", "de", "es", "it", "ja", "ko", "pt", "ru", "zh"];
+
+      // execute
+      const output = input.map((item) => isoStrapiToLocalazy(item));
+
+      // verify
+      const expected = input;
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-region", () => {
+      // setup
+      const input = ["en-US", "fr-CA", "de-DE", "es-ES", "it-IT", "ja-JP", "ko-KR", "pt-BR", "ru-RU", "zh-CN"];
+
+      // execute
+      const output = input.map((item) => isoStrapiToLocalazy(item));
+
+      // verify
+      const expected = ["en_US", "fr_CA", "de_DE", "es_ES", "it_IT", "ja_JP", "ko_KR", "pt_BR", "ru_RU", "zh_CN"];
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-script", () => {
+      // setup
+      const input = ["en-Latn", "fr-Latn", "de-Latn", "es-Latn", "it-Latn", "ja-Latn", "ko-Latn", "pt-Latn", "ru-Latn", "zh-Latn"];
+
+      // execute
+      const output = input.map((item) => isoStrapiToLocalazy(item));
+
+      // verify
+      const expected = ["en#Latn", "fr#Latn", "de#Latn", "es#Latn", "it#Latn", "ja#Latn", "ko#Latn", "pt#Latn", "ru#Latn", "zh#Latn"];
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-script-region", () => {
+      // setup
+      const input = ["en-Latn-US", "fr-Latn-CA", "de-Latn-DE", "es-Latn-ES", "it-Latn-IT", "ja-Latn-JP", "ko-Latn-KR", "pt-Latn-BR", "ru-Latn-RU", "zh-Hant-CN"];
+
+      // execute
+      const output = input.map((item) => isoStrapiToLocalazy(item));
+
+      // verify
+      const expected = ["en_US#Latn", "fr_CA#Latn", "de_DE#Latn", "es_ES#Latn", "it_IT#Latn", "ja_JP#Latn", "ko_KR#Latn", "pt_BR#Latn", "ru_RU#Latn", "zh_CN#Hant"];
+      expect(output).toEqual(expected);
+    });
+  });
+
+  describe("transform Strapi ISO to Localazy ISO", () => {
+    it("should transform codes containing lang only", () => {
+      // setup
+      const input = ["en", "fr", "de", "es", "it", "ja", "ko", "pt", "ru", "zh"];
+
+      // execute
+      const output = input.map((item) => isoLocalazyToStrapi(item));
+
+      // verify
+      const expected = input;
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-region", () => {
+      // setup
+      const input = ["en_US", "fr_CA", "de_DE", "es_ES", "it_IT", "ja_JP", "ko_KR", "pt_BR", "ru_RU", "zh_CN"];
+
+      // execute
+      const output = input.map((item) => isoLocalazyToStrapi(item));
+
+      // verify
+      const expected = ["en-US", "fr-CA", "de-DE", "es-ES", "it-IT", "ja-JP", "ko-KR", "pt-BR", "ru-RU", "zh-CN"];
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-script", () => {
+      // setup
+      const input = ["en#Latn", "fr#Latn", "de#Latn", "es#Latn", "it#Latn", "ja#Latn", "ko#Latn", "pt#Latn", "ru#Latn", "zh#Latn"];
+
+      // execute
+      const output = input.map((item) => isoLocalazyToStrapi(item));
+
+      // verify
+      const expected = ["en-Latn", "fr-Latn", "de-Latn", "es-Latn", "it-Latn", "ja-Latn", "ko-Latn", "pt-Latn", "ru-Latn", "zh-Latn"];
+      expect(output).toEqual(expected);
+    });
+
+    it("should transform codes containing lang-script-region", () => {
+      // setup
+      const input = ["en_US#Latn", "fr_CA#Latn", "de_DE#Latn", "es_ES#Latn", "it_IT#Latn", "ja_JP#Latn", "ko_KR#Latn", "pt_BR#Latn", "ru_RU#Latn", "zh_CN#Hant"];
+
+      // execute
+      const output = input.map((item) => isoLocalazyToStrapi(item));
+      // verify
+      const expected = ["en-Latn-US", "fr-Latn-CA", "de-Latn-DE", "es-Latn-ES", "it-Latn-IT", "ja-Latn-JP", "ko-Latn-KR", "pt-Latn-BR", "ru-Latn-RU", "zh-Hant-CN"];
+      expect(output).toEqual(expected);
+    });
+  });
+});

package/server/utils/intl-display-name.js

@@ -1,7 +1,4 @@
-const { isoStrapiToLocalazy } = require("./iso-locales-utils.js");
-
-module.exports = (isoCode) => {
-  const isoDashed = isoStrapiToLocalazy(isoCode);
+module.exports = (isoStrapi) => {
   let languageNames = new Intl.DisplayNames(["en"], { type: "language" });
-  return languageNames.of(isoDashed);
+  return languageNames.of(isoStrapi);
 };

package/server/utils/iso-locales-utils.js

@@ -5,7 +5,28 @@ const isoStrapiToLocalazy = (isoStrapi) => {
     return null;
   }
 
-  return isoStrapi.replace("_", "-");
+  const split = isoStrapi.split("-");
+  const language = split[0];
+
+  const hasRegionAndScript = split.length === 3;
+  if (hasRegionAndScript) {
+    const script = split[1];
+    const region = split[2];
+    return `${language}_${region}#${script}`;
+  }
+
+  const hasPossiblyRegion = split.length === 2;
+  if (hasPossiblyRegion) {
+    const regionOrScript = split[1];
+
+    // is it script - the way Strapi resolves that
+    const isItRegion = regionOrScript.toUpperCase() === regionOrScript;
+
+    // it is region; otherwise it is script
+    return isItRegion ? `${language}_${regionOrScript}` : `${language}#${regionOrScript}`;
+  }
+
+  return isoStrapi.replace("-", "_");
 };
 
 const isoLocalazyToStrapi = (isoLocalazy) => {
@@ -13,7 +34,24 @@ const isoLocalazyToStrapi = (isoLocalazy) => {
     return null;
   }
 
-  return isoLocalazy.replace("-", "_");
+  const scriptIndex = isoLocalazy.indexOf("#");
+  const hasScript = scriptIndex > -1;
+  if (hasScript) {
+    const script = isoLocalazy.substring(scriptIndex + 1);
+    const isoLocalazyWithoutScript = isoLocalazy.substring(0, scriptIndex);
+    const split = isoLocalazyWithoutScript.split("_");
+    const language = split[0];
+    const region = split[1];
+
+    if (!region) {
+      return `${language}-${script}`;
+    }
+
+    const isoStrapi = `${language}-${script}-${region.toUpperCase()}`;
+    return isoStrapi;
+  }
+
+  return isoLocalazy.replace("_", "-");
 };
 
 module.exports = {