locize/src/implementations/i18nextImplementation.js

This package adds the incontext editor to your i18next setup.

export function getImplementation (i18n) {
  const impl = {
    getResource: (lng, ns, key) => {
      return i18n.getResource && i18n.getResource(lng, ns, key)
    },
    setResource: (lng, ns, key, value) => {
      return i18n.addResource(lng, ns, key, value, { silent: true })
    },
    getResourceBundle: (lng, ns, cb) => {
      i18n.loadNamespaces(ns, () => {
        cb(i18n.getResourceBundle(lng, ns))
      })
    },
    getDefaultNS: () => {
      return i18n.options.defaultNS
    },
    getLng: () => {
      return (
        i18n.resolvedLanguage ||
        (i18n.languages && i18n.languages[0]) ||
        i18n.options.lng
      )
    },
    getSourceLng: () => {
      const fallback = i18n.options.fallbackLng
      if (typeof fallback === 'string') return fallback
      if (Array.isArray(fallback)) return fallback[fallback.length - 1]

      if (fallback && fallback.default) {
        if (typeof fallback.default === 'string') return fallback
        if (Array.isArray(fallback.default)) { return fallback.default[fallback.default.length - 1] }
      }

      if (typeof fallback === 'function') {
        const res = fallback(i18n.resolvedLanguage)
        if (typeof res === 'string') return res
        if (Array.isArray(res)) return res[res.length - 1]
      }

      return 'dev'
    },
    getLocizeDetails: () => {
      let backendName
      if (
        i18n.services.backendConnector.backend &&
        i18n.services.backendConnector.backend.options &&
        i18n.services.backendConnector.backend.options.loadPath &&
        i18n.services.backendConnector.backend.options.loadPath.indexOf(
          '.locize.'
        ) > 0
      ) {
        // Must match the actual class name exported by i18next-locize-backend
        // (capital N in "Next"). The locize editor compares this string
        // exactly to decide whether the host is talking to the Locize CDN.
        backendName = 'I18NextLocizeBackend'
      } else {
        backendName = i18n.services.backendConnector.backend
          ? i18n.services.backendConnector.backend.constructor.name
          : 'options.resources'
      }

      const opts = {
        backendName,
        sourceLng: impl.getSourceLng(),
        i18nFormat:
          i18n.options.compatibilityJSON === 'v3' ? 'i18next_v3' : 'i18next_v4',
        i18nFramework: 'i18next',
        isLocizify: i18n.options.isLocizify,
        defaultNS: i18n.options.defaultNS,
        targetLngs: [
          ...new Set(
            [].concat(i18n.options.preload, i18n.options.supportedLngs, [
              impl.getLng()
            ])
          )
        ].filter(
          l =>
            l !== 'cimode' &&
            l !== false &&
            l !== 'false' &&
            l !== undefined &&
            l !== impl.getSourceLng()
        ),
        ns: [
          ...new Set(
            [].concat(
              i18n.options.ns,
              i18n.options.fallbackNS,
              i18n.options.defaultNS
            )
          )
        ].filter(n => n !== false && n !== 'false')
      }

      if (!i18n.options.backend && !i18n.options.editor) return opts
      const pickFrom = i18n.options.editor || i18n.options.backend
      return {
        ...opts,
        projectId: pickFrom.projectId,
        version: pickFrom.version
      }
    },
    bindLanguageChange: cb => {
      i18n.on('languageChanged', cb)
    },
    bindMissingKeyHandler: cb => {
      i18n.options.missingKeyHandler = (lng, ns, k, val, isUpdate, opts) => {
        if (!isUpdate) cb(lng, ns, k, val)
      }
    },
    triggerRerender: () => {
      i18n.emit('editorSaved')
    }
  }
  return impl
}