feat: add option to clear cache in @bothrs/translations

Author: thgh

packages/translations/README.md

@@ -34,6 +34,7 @@ export function AirtableExample() {
 | -------------- | ------------------------------------------------------- |
 | expirationTime | Time between translation refreshes in ms                |
 | loadPath       | The endpoint from where the translations will be loaded |
+| storagePrefix  | Prefix for the location where the cache is persisted    |
 
 ### Airtable table structure
 
@@ -69,7 +70,29 @@ export function GenericExample() {
 }
 ```
 
+## Refresh translations
+
+If translations change commonly, consider updating the `storagePrefix` to make sure all users are using the latest translations. This prefix acts as a cache-busting mechanism.
+
+```tsx
+import { useTranslations } from '@bothrs/translations'
+import i18next from 'i18next'
+
+export function GenericExample() {
+  const ready = useTranslations({
+    // Increment manually
+    storagePrefix: 'i18n_3_',
+    // Refresh on every app update
+    storagePrefix: 'i18n_' + Constants.manifest?.version + '_',
+  })
+  return <div>{ready ? i18next.t('Ready') : 'Loading'}</div>
+}
+```
+
+## All options
+
 | Name           | Explanation                                             |
 | -------------- | ------------------------------------------------------- |
 | expirationTime | Time between translation refreshes in ms                |
 | loadPath       | The endpoint from where the translations will be loaded |
+| storagePrefix  | Prefix for the location where the cache is persisted    |

packages/translations/src/index.ts

@@ -36,6 +36,7 @@ export function useTranslations(
 }
 
 export function initTranslations({
+  storagePrefix = 'i18n_',
   expirationTime,
   fetchOptions,
   ...options
@@ -54,7 +55,7 @@ export function initTranslations({
     backend: {
       backends: [StorageBackend, MultiloadAdapter],
       backendOptions: [
-        { prefix: 'i18n_', expirationTime },
+        { prefix: storagePrefix, expirationTime },
         { backend: Fetch, backendOption: fetchOptions },
       ],
     },

packages/translations/src/types.ts

@@ -37,6 +37,8 @@ export interface TranslationRow {
 }
 
 export interface TranslationInitParameters extends InitOptions {
+  /** allows to bust the cache in a declarative way, warning: previous cached versions are kept in storage forever */
+  storagePrefix?: string
   /** expirationTime time between between revalidation intervals, defaults to 1 week */
   expirationTime?: number
   /** Configuration for 'i18next-fetch-backend' */