@forthtilliath/expo-backup-ui 0.2.0 → 0.3.0

package/README.md

@@ -54,4 +54,6 @@ Every action runs one at a time (a double tap is ignored) and shows errors in an
 
 The encryption section only appears when the manager's encryption isn't `off`: a switch in `optional` mode, a status line in `required` mode, and — on demand only, since it is the key — the recovery code, shown selectable so it can be copied into a password manager.
 
-Also exported: `useBackupState(manager)` (the manager's state, re-rendering on change) and `errorMessage(error, labels)`.
+A failing automatic backup is spelled out on the screen: what went wrong and what to do, since when uploads fail, and the technical cause (selectable, to send to the developer). Linking an account whose first upload fails says so instead of "enabled", and "Back up now" confirms or explains.
+
+Also exported: `useBackupState(manager)` (the manager's state, re-rendering on change), `useCloudBackupProblem(manager)` (a failure to warn about outside the screen, see `getCloudBackupProblem` in expo-backup), `errorMessage(error, labels)` and `codeMessage(labels, code, detail)`.

package/dist/CloudSection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudSection.d.ts","sourceRoot":"","sources":["../src/CloudSection.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAAE,+BAgG1D"}
+{"version":3,"file":"CloudSection.d.ts","sourceRoot":"","sources":["../src/CloudSection.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAAE,+BA6H1D"}

package/dist/CloudSection.js

@@ -1,11 +1,16 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Alert, Text, View } from "react-native";
 import { ActionButton } from "./ActionButton.js";
-import { askConfirmation, askConflictChoice } from "./dialogs.js";
+import { askConfirmation, askConflictChoice, codeMessage } from "./dialogs.js";
 /** Linking a Google account, then the automatic backup's status and actions. */
 export function CloudSection({ ui }) {
     const { manager, state, t, styles, busy, run } = ui;
     const { cloudAccount } = state;
+    /** The failure of the upload that just ran (kept in the state, never thrown), if any. */
+    function lastUploadError() {
+        const { cloudError, cloudErrorDetail } = manager.getState();
+        return cloudError ? codeMessage(t, cloudError, cloudErrorDetail) : null;
+    }
     const handleConnect = () => run(async () => {
         const result = await manager.connectCloud();
         if (result.status === "cancelled")
@@ -18,11 +23,23 @@ export function CloudSection({ ui }) {
             }
             await manager.resolveConflict(result, keep);
         }
-        Alert.alert(t.connectedTitle, t.connectedConfirm(result.email));
+        // Linking succeeds even when its first upload fails (Drive full…):
+        // saying "enabled" then would hide the problem.
+        const uploadError = lastUploadError();
+        if (uploadError)
+            Alert.alert(t.connectedButFailedTitle, uploadError);
+        else
+            Alert.alert(t.connectedTitle, t.connectedConfirm(result.email));
     });
     const handleSyncNow = () => run(async () => {
-        await manager.syncNow();
-        // Errors are kept in the state (shown below) rather than thrown.
+        if (await manager.syncNow()) {
+            Alert.alert(t.syncDoneTitle, t.syncDoneMessage);
+            return;
+        }
+        // False also when an upload was already running: it reports itself.
+        const uploadError = lastUploadError();
+        if (uploadError)
+            Alert.alert(t.syncFailedTitle, uploadError);
     });
     const handleRestore = () => run(async () => {
         const remote = await manager.fetchCloudBackup();
@@ -40,5 +57,5 @@ export function CloudSection({ ui }) {
     if (!cloudAccount) {
         return (_jsxs(View, { style: styles.section, children: [_jsx(Text, { style: styles.sectionTitle, children: t.cloudTitle }), _jsx(Text, { style: styles.hint, children: t.cloudHint }), _jsx(ActionButton, { label: t.connectButton, onPress: () => void handleConnect(), busy: busy, styles: styles })] }));
     }
-    return (_jsxs(View, { style: styles.section, children: [_jsx(Text, { style: styles.sectionTitle, children: t.cloudTitle }), _jsx(Text, { style: styles.status, children: cloudAccount.email }), _jsxs(Text, { style: styles.status, children: [t.lastCloudBackup(ui.formatDate(state.lastCloudBackupAt)), state.cloudPending && !state.cloudError ? t.cloudPending : ""] }), state.cloudError && (_jsx(Text, { style: styles.errorText, children: t.errors[state.cloudError] })), _jsx(Text, { style: styles.hint, children: t.autoHint }), _jsx(ActionButton, { label: t.syncNowButton, variant: "secondary", onPress: () => void handleSyncNow(), disabled: busy, styles: styles }), _jsx(ActionButton, { label: t.restoreCloudButton, variant: "secondary", onPress: () => void handleRestore(), disabled: busy, styles: styles }), _jsx(ActionButton, { label: t.disconnectButton, variant: "ghost", onPress: () => void handleDisconnect(), disabled: busy, styles: styles })] }));
+    return (_jsxs(View, { style: styles.section, children: [_jsx(Text, { style: styles.sectionTitle, children: t.cloudTitle }), _jsx(Text, { style: styles.status, children: cloudAccount.email }), _jsxs(Text, { style: styles.status, children: [t.lastCloudBackup(ui.formatDate(state.lastCloudBackupAt)), state.cloudPending && !state.cloudError ? t.cloudPending : ""] }), state.cloudError && (_jsxs(_Fragment, { children: [_jsx(Text, { style: styles.errorText, children: codeMessage(t, state.cloudError) }), state.cloudFailingSince !== null && (_jsx(Text, { style: styles.hint, children: t.failingSince(ui.formatDate(state.cloudFailingSince)) })), state.cloudErrorDetail && (_jsx(Text, { style: styles.hint, selectable: true, children: t.errorDetail(state.cloudErrorDetail) }))] })), _jsx(Text, { style: styles.hint, children: t.autoHint }), _jsx(ActionButton, { label: t.syncNowButton, variant: "secondary", onPress: () => void handleSyncNow(), disabled: busy, styles: styles }), _jsx(ActionButton, { label: t.restoreCloudButton, variant: "secondary", onPress: () => void handleRestore(), disabled: busy, styles: styles }), _jsx(ActionButton, { label: t.disconnectButton, variant: "ghost", onPress: () => void handleDisconnect(), disabled: busy, styles: styles })] }));
 }

package/dist/dialogs.d.ts

@@ -1,4 +1,11 @@
+import { type BackupErrorCode } from "@forthtilliath/expo-backup/errors";
 import type { BackupScreenLabels } from "./labels.js";
+/**
+ * Message of an error code, followed by its technical cause when known. The
+ * code may come from a state saved by another version: unknown ones fall
+ * back to the generic message rather than to nothing.
+ */
+export declare function codeMessage(t: BackupScreenLabels, code: BackupErrorCode, detail?: string | null): string;
 /** User-facing text of any error: localized for the package's own, as is for the app's. */
 export declare function errorMessage(error: unknown, t: BackupScreenLabels): string;
 export declare function showError(error: unknown, t: BackupScreenLabels): void;

package/dist/dialogs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dialogs.d.ts","sourceRoot":"","sources":["../src/dialogs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAI1E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAErE;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAC7B,CAAC,EAAE,kBAAkB,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,kBAAkB,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC,CAmCpC"}
+{"version":3,"file":"dialogs.d.ts","sourceRoot":"","sources":["../src/dialogs.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE,kBAAkB,EACrB,IAAI,EAAE,eAAe,EACrB,MAAM,GAAE,MAAM,GAAG,IAAW,GAC3B,MAAM,CAGR;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAM1E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAErE;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAC7B,CAAC,EAAE,kBAAkB,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,kBAAkB,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC,CAmCpC"}

package/dist/dialogs.js

@@ -1,10 +1,20 @@
 import { Alert } from "react-native";
 // Subpath: errors.js loads no native module, unlike the package root.
-import { BackupError } from "@forthtilliath/expo-backup/errors";
+import { BackupError, backupErrorDetail, } from "@forthtilliath/expo-backup/errors";
+/**
+ * Message of an error code, followed by its technical cause when known. The
+ * code may come from a state saved by another version: unknown ones fall
+ * back to the generic message rather than to nothing.
+ */
+export function codeMessage(t, code, detail = null) {
+    const message = t.errors[code] ?? t.errors.unknown;
+    return detail ? `${message}\n\n${t.errorDetail(detail)}` : message;
+}
 /** User-facing text of any error: localized for the package's own, as is for the app's. */
 export function errorMessage(error, t) {
+    // The app's own errors (`parse`…) are already meant for the user: no detail.
     if (error instanceof BackupError)
-        return t.errors[error.code];
+        return codeMessage(t, error.code, backupErrorDetail(error));
     if (error instanceof Error && error.message)
         return error.message;
     return t.errors.unknown;

package/dist/hooks.d.ts

@@ -1,6 +1,13 @@
 import type { BackupManager, BackupState } from "@forthtilliath/expo-backup";
+import { type CloudBackupProblem, type CloudBackupProblemOptions } from "@forthtilliath/expo-backup/cloudBackupProblem";
 /** The manager's state (linked account, last backup, pending upload…), re-rendering on change. */
 export declare function useBackupState<T>(manager: BackupManager<T>): BackupState;
+/**
+ * The automatic backup's failure to tell the user about outside the backup
+ * screen (banner, alert, tab badge), or null — see `getCloudBackupProblem`.
+ * Turn its code into text with `codeMessage`.
+ */
+export declare function useCloudBackupProblem<T>(manager: BackupManager<T>, options?: CloudBackupProblemOptions): CloudBackupProblem | null;
 /**
  * Starts the manager for the component's lifetime: reads the persisted state,
  * retries a pending upload, flushes when the app goes to the background.

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE7E,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAExE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAEhE"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAE/B,MAAM,+CAA+C,CAAC;AAEvD,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAExE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE,yBAAyB,GAClC,kBAAkB,GAAG,IAAI,CAE3B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAEhE"}

package/dist/hooks.js

@@ -1,8 +1,18 @@
 import { useEffect, useSyncExternalStore } from "react";
+// Subpath: pure module, no native peer loaded.
+import { getCloudBackupProblem, } from "@forthtilliath/expo-backup/cloudBackupProblem";
 /** The manager's state (linked account, last backup, pending upload…), re-rendering on change. */
 export function useBackupState(manager) {
     return useSyncExternalStore(manager.subscribe, manager.getState);
 }
+/**
+ * The automatic backup's failure to tell the user about outside the backup
+ * screen (banner, alert, tab badge), or null — see `getCloudBackupProblem`.
+ * Turn its code into text with `codeMessage`.
+ */
+export function useCloudBackupProblem(manager, options) {
+    return getCloudBackupProblem(useBackupState(manager), options);
+}
 /**
  * Starts the manager for the component's lifetime: reads the persisted state,
  * retries a pending upload, flushes when the app goes to the background.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./BackupScreen.js";
-export { errorMessage } from "./dialogs.js";
+export { codeMessage, errorMessage } from "./dialogs.js";
 export * from "./hooks.js";
 export * from "./labels.js";
 export type { BackupScreenStyles } from "./styles.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACzD,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
 export * from "./BackupScreen.js";
-export { errorMessage } from "./dialogs.js";
+export { codeMessage, errorMessage } from "./dialogs.js";
 export * from "./hooks.js";
 export * from "./labels.js";

package/dist/labels.d.ts

@@ -8,8 +8,14 @@ export interface BackupScreenLabels {
     connectButton: string;
     connectedTitle: string;
     connectedConfirm: (email: string) => string;
+    /** Account linked, but its first upload failed: shown instead of `connectedTitle`. */
+    connectedButFailedTitle: string;
     lastCloudBackup: (date: string) => string;
     cloudPending: string;
+    failingSince: (date: string) => string;
+    syncDoneTitle: string;
+    syncDoneMessage: string;
+    syncFailedTitle: string;
     autoHint: string;
     syncNowButton: string;
     restoreCloudButton: string;
@@ -56,6 +62,8 @@ export interface BackupScreenLabels {
     confirm: string;
     close: string;
     errorTitle: string;
+    /** Technical cause under an error message ("HTTP 403 · storageQuotaExceeded"). */
+    errorDetail: (detail: string) => string;
     errors: Record<BackupErrorCode, string>;
 }
 /** What `labels` accepts: any subset of the texts, error messages included. */

package/dist/labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"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"}

package/dist/labels.en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"labels.en.d.ts","sourceRoot":"","sources":["../src/labels.en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,QAAQ,EAAE,kBAkGtB,CAAC"}
+{"version":3,"file":"labels.en.d.ts","sourceRoot":"","sources":["../src/labels.en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,QAAQ,EAAE,kBAkHtB,CAAC"}

package/dist/labels.en.js

@@ -4,8 +4,13 @@ export const enLabels = {
     connectButton: "Connect Google Drive",
     connectedTitle: "Automatic backup enabled",
     connectedConfirm: (email) => `Your data is now sent to the Google Drive of ${email} after every change.`,
+    connectedButFailedTitle: "Account linked, but the upload failed",
     lastCloudBackup: (date) => `Last upload: ${date}`,
     cloudPending: " · upload pending…",
+    failingSince: (date) => `Uploads have been failing since ${date}.`,
+    syncDoneTitle: "Backup uploaded",
+    syncDoneMessage: "Your data is up to date on Google Drive.",
+    syncFailedTitle: "The backup couldn't be uploaded",
     autoHint: "Uploaded automatically after every change.",
     syncNowButton: "Back up now",
     restoreCloudButton: "Restore from Google Drive",
@@ -51,17 +56,21 @@ export const enLabels = {
     confirm: "OK",
     close: "Close",
     errorTitle: "Error",
+    errorDetail: (detail) => `Technical detail: ${detail}`,
     errors: {
-        "google-unavailable": "Google Drive backup isn't available in this version of the app.",
-        "play-services-unavailable": "Google Play services aren't available on this phone.",
-        "oauth-misconfigured": "Google doesn't recognize this version of the app (missing OAuth client or different SHA-1).",
-        "sign-in-failed": "Signing in to Google failed.",
-        "reconnect-required": "Reconnect your Google account to resume backups.",
-        "drive-api-disabled": "The Google Drive API isn't enabled in the app's Google Cloud project.",
-        "drive-permission-missing": "Access to Google Drive wasn't granted. Reconnect your account and allow Drive access.",
-        "drive-access-denied": "Google Drive denied access. Reconnect your Google account.",
-        "drive-unavailable": "Google Drive is temporarily unavailable.",
-        network: "No internet connection.",
+        "google-unavailable": "Google Drive backup isn't available in this version of the app. Use the manual backup (Export my data).",
+        "play-services-unavailable": "Google Play services aren't available on this phone, so Google Drive backup can't work. Use the manual backup (Export my data).",
+        "oauth-misconfigured": "Google doesn't recognize this version of the app (missing OAuth client or different SHA-1). Nothing you can do: let the app's developer know.",
+        "sign-in-failed": "Signing in to Google failed. Check your internet connection, then try again.",
+        "reconnect-required": "Google no longer lets the app reach your Drive (access removed or expired). Tap “Disconnect”, then reconnect your Google account.",
+        "drive-storage-full": "Your Google storage is full, so the backup can't be uploaded anymore. Free up some space (Gmail, Drive and Photos share it, see one.google.com/storage), then tap “Back up now”.",
+        "drive-rate-limited": "Google Drive is receiving too many requests right now. The upload will be retried automatically later.",
+        "drive-blocked-by-admin": "The administrator of this Google account (work, school…) doesn't let apps use Drive. Disconnect it and link a personal Google account instead.",
+        "drive-api-disabled": "The Google Drive API isn't enabled in the app's Google Cloud project. Nothing you can do: let the app's developer know.",
+        "drive-permission-missing": "Access to Google Drive wasn't granted. Tap “Disconnect”, then reconnect your account and tick Drive access.",
+        "drive-access-denied": "Google Drive refused the upload for an unexpected reason. If it happens again, tap “Disconnect” and reconnect your Google account; otherwise let the app's developer know, with the technical detail.",
+        "drive-unavailable": "Google Drive is temporarily unavailable. The upload will be retried automatically.",
+        network: "No internet connection. The upload will be retried automatically once you're online.",
         "missing-key": "This backup is encrypted with a key this phone doesn't know. Enter the recovery code of the device that created it.",
         "invalid-recovery-code": "This recovery code contains a typo.",
         "recovery-code-mismatch": "This recovery code is valid, but it isn't the one that encrypted this file.",

package/dist/labels.fr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"labels.fr.d.ts","sourceRoot":"","sources":["../src/labels.fr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,QAAQ,EAAE,kBAuGtB,CAAC"}
+{"version":3,"file":"labels.fr.d.ts","sourceRoot":"","sources":["../src/labels.fr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,QAAQ,EAAE,kBAsHtB,CAAC"}

package/dist/labels.fr.js

@@ -4,8 +4,13 @@ export const frLabels = {
     connectButton: "Connecter Google Drive",
     connectedTitle: "Sauvegarde automatique activée",
     connectedConfirm: (email) => `Tes données sont désormais envoyées sur le Google Drive de ${email} après chaque modification.`,
+    connectedButFailedTitle: "Compte relié, mais l'envoi a échoué",
     lastCloudBackup: (date) => `Dernier envoi : ${date}`,
     cloudPending: " · envoi en attente…",
+    failingSince: (date) => `Les envois échouent depuis le ${date}.`,
+    syncDoneTitle: "Sauvegarde envoyée",
+    syncDoneMessage: "Tes données sont à jour sur Google Drive.",
+    syncFailedTitle: "La sauvegarde n'a pas pu être envoyée",
     autoHint: "Envoi automatique après chaque modification.",
     syncNowButton: "Sauvegarder maintenant",
     restoreCloudButton: "Restaurer depuis Google Drive",
@@ -51,17 +56,21 @@ export const frLabels = {
     confirm: "Valider",
     close: "Fermer",
     errorTitle: "Erreur",
+    errorDetail: (detail) => `Détail technique : ${detail}`,
     errors: {
-        "google-unavailable": "La sauvegarde Google Drive n'est pas disponible dans cette version de l'app.",
-        "play-services-unavailable": "Les services Google Play sont indisponibles sur ce téléphone.",
-        "oauth-misconfigured": "Google ne reconnaît pas cette version de l'app (client OAuth absent ou empreinte SHA-1 différente).",
-        "sign-in-failed": "La connexion à Google a échoué.",
-        "reconnect-required": "Reconnecte ton compte Google pour reprendre la sauvegarde.",
-        "drive-api-disabled": "L'API Google Drive n'est pas activée dans le projet Google Cloud de l'app.",
-        "drive-permission-missing": "L'accès à Google Drive n'a pas été autorisé. Reconnecte ton compte en acceptant l'accès à Drive.",
-        "drive-access-denied": "Google Drive a refusé l'accès. Reconnecte ton compte Google.",
-        "drive-unavailable": "Google Drive est momentanément indisponible.",
-        network: "Pas de connexion internet.",
+        "google-unavailable": "La sauvegarde Google Drive n'est pas disponible dans cette version de l'app. Utilise la sauvegarde manuelle (Exporter mes données).",
+        "play-services-unavailable": "Les services Google Play sont indisponibles sur ce téléphone : la sauvegarde Google Drive ne peut pas fonctionner. Utilise la sauvegarde manuelle (Exporter mes données).",
+        "oauth-misconfigured": "Google ne reconnaît pas cette version de l'app (client OAuth absent ou empreinte SHA-1 différente). Tu n'y peux rien : préviens le développeur de l'app.",
+        "sign-in-failed": "La connexion à Google a échoué. Vérifie ta connexion internet, puis réessaie.",
+        "reconnect-required": "Google n'autorise plus l'app à accéder à ton Drive (accès retiré ou expiré). Appuie sur « Déconnecter », puis reconnecte ton compte Google.",
+        "drive-storage-full": "Ton espace de stockage Google est plein : la sauvegarde ne peut plus être envoyée. Libère de la place (Gmail, Drive et Photos partagent le même espace, voir one.google.com/storage), puis appuie sur « Sauvegarder maintenant ».",
+        "drive-rate-limited": "Google Drive reçoit trop de demandes pour le moment. L'envoi sera retenté automatiquement plus tard.",
+        "drive-blocked-by-admin": "L'administrateur de ce compte Google (travail, école…) interdit aux apps d'utiliser Drive. Déconnecte-le et relie plutôt un compte Google personnel.",
+        "drive-api-disabled": "L'API Google Drive n'est pas activée dans le projet Google Cloud de l'app. Tu n'y peux rien : préviens le développeur de l'app.",
+        "drive-permission-missing": "L'accès à Google Drive n'a pas été autorisé. Appuie sur « Déconnecter », puis reconnecte ton compte en cochant l'accès à Drive.",
+        "drive-access-denied": "Google Drive a refusé l'envoi pour une raison inattendue. Si ça se reproduit, appuie sur « Déconnecter » puis reconnecte ton compte Google, et sinon préviens le développeur de l'app avec le détail technique.",
+        "drive-unavailable": "Google Drive est momentanément indisponible. L'envoi sera retenté automatiquement.",
+        network: "Pas de connexion internet. L'envoi sera retenté automatiquement une fois connecté.",
         "missing-key": "Cette sauvegarde est chiffrée avec une clé inconnue de ce téléphone. Saisis la clé de secours de l'appareil qui l'a créée.",
         "invalid-recovery-code": "Cette clé de secours contient une faute de frappe.",
         "recovery-code-mismatch": "Cette clé de secours est valide, mais ce n'est pas celle qui a chiffré ce fichier.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forthtilliath/expo-backup-ui",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
@@ -22,7 +22,7 @@
     "./*": "./dist/*.js"
   },
   "dependencies": {
-    "@forthtilliath/expo-backup": "^0.2.0"
+    "@forthtilliath/expo-backup": "^0.3.0"
   },
   "peerDependencies": {
     "react": ">=19",