@oxy.so/core 1.18.0 → 3.0.0

package/dist/esm/crypto/signatureService.js

@@ -10,6 +10,7 @@
 import { signEnvelope, signMessage, verifySignature, sha256, loadExpoCrypto, loadNodeCrypto, isReactNative, isNodeJS, } from '@oxy.so/protocol';
 import { KeyManager } from './keyManager.js';
 import { logger } from '../logger/index.js';
+// biome-ignore lint/complexity/noStaticOnlyClass: a public, static-only API surface (`X.method()`) that consumers and tests call and spy on by name.
 export class SignatureService {
     /**
      * Generate a random challenge string (for offline use)

package/dist/esm/i18n/accountCategoryLabels.js

@@ -1,10 +1,10 @@
-import enUS from './locales/en-US.json' with { type: "json" };
+import enUS from './locales/en-US.js';
 import { translate } from './index.js';
 /**
  * Every account category's English name, keyed by its stable id.
  *
  * **The annotation is the point.** The vocabulary lives in `@oxy.so/contracts`
- * and the names live in `locales/en-US.json`, so they are two lists that must
+ * and the names live in `locales/en-US.ts`, so they are two lists that must
  * agree and nothing but a type can make them. Declaring the JSON node as a
  * TOTAL `Record<AccountCategoryId, string>` turns "somebody added a category at
  * Oxy and nobody wrote its English" into a `TS2741` naming the missing id, at

package/dist/esm/i18n/accountRoleLabels.js

@@ -1,4 +1,4 @@
-import enUS from './locales/en-US.json' with { type: "json" };
+import enUS from './locales/en-US.js';
 import { translate } from './index.js';
 /**
  * Every account member role's English name, keyed by its stable id.

package/dist/esm/i18n/index.js

@@ -1,61 +1,102 @@
-import enUS from './locales/en-US.json' with { type: "json" };
-import esES from './locales/es-ES.json' with { type: "json" };
-import caES from './locales/ca-ES.json' with { type: "json" };
-import frFR from './locales/fr-FR.json' with { type: "json" };
-import deDE from './locales/de-DE.json' with { type: "json" };
-import itIT from './locales/it-IT.json' with { type: "json" };
-import ptPT from './locales/pt-PT.json' with { type: "json" };
-import jaJP from './locales/ja-JP.json' with { type: "json" };
-import koKR from './locales/ko-KR.json' with { type: "json" };
-import zhCN from './locales/zh-CN.json' with { type: "json" };
-import arSA from './locales/ar-SA.json' with { type: "json" };
+import enUS from './locales/en-US.js';
 import { getBaseLanguage } from '../utils/languageUtils.js';
-const DICTS = {
-    'en': enUS,
-    'en-US': enUS,
-    'es': esES,
-    'es-ES': esES,
-    'ca': caES,
-    'ca-ES': caES,
-    'fr': frFR,
-    'fr-FR': frFR,
-    'de': deDE,
-    'de-DE': deDE,
-    'it': itIT,
-    'it-IT': itIT,
-    'pt': ptPT,
-    'pt-PT': ptPT,
-    'ja': jaJP,
-    'ja-JP': jaJP,
-    'ko': koKR,
-    'ko-KR': koKR,
-    'zh': zhCN,
-    'zh-CN': zhCN,
-    'ar': arSA,
-    'ar-SA': arSA,
-};
 const FALLBACK = 'en-US';
 /**
- * Resolve a locale tag to the key of the dictionary that should serve it.
- *
- * Account locales are full BCP-47 tags (e.g. `es-MX`, `pt-BR`, `fr-CA`), but a
- * translation dictionary is shipped per base language. Resolution order:
- *   1. Exact dictionary for the tag (e.g. `es-ES`).
- *   2. Dictionary for the base subtag (e.g. `es-MX` → `es`).
- *   3. The English fallback.
+ * Every dictionary but English loads on demand: an app ships only the languages
+ * its people actually use (~200 KB of the ~285 KB total is non-English). English
+ * is the fallback for every missing key, so it is always present.
  */
-function resolveLang(locale) {
+const LOADERS = {
+    'es-ES': () => import('./locales/es-ES.js'),
+    'ca-ES': () => import('./locales/ca-ES.js'),
+    'fr-FR': () => import('./locales/fr-FR.js'),
+    'de-DE': () => import('./locales/de-DE.js'),
+    'it-IT': () => import('./locales/it-IT.js'),
+    'pt-PT': () => import('./locales/pt-PT.js'),
+    'ja-JP': () => import('./locales/ja-JP.js'),
+    'ko-KR': () => import('./locales/ko-KR.js'),
+    'zh-CN': () => import('./locales/zh-CN.js'),
+    'ar-SA': () => import('./locales/ar-SA.js'),
+};
+/** Base subtag → the dictionary that serves it. */
+const ALIASES = {
+    en: 'en-US', es: 'es-ES', ca: 'ca-ES', fr: 'fr-FR', de: 'de-DE', it: 'it-IT',
+    pt: 'pt-PT', ja: 'ja-JP', ko: 'ko-KR', zh: 'zh-CN', ar: 'ar-SA',
+};
+const DICTS = { [FALLBACK]: enUS };
+const pending = new Map();
+const listeners = new Set();
+let version = 0;
+/** The dictionary key serving `locale`, whether or not it is loaded yet. */
+function dictionaryFor(locale) {
     if (locale) {
-        if (DICTS[locale])
+        if (locale === FALLBACK || LOADERS[locale])
             return locale;
-        const base = getBaseLanguage(locale);
-        if (DICTS[base])
+        const base = ALIASES[getBaseLanguage(locale)];
+        if (base)
             return base;
     }
     return FALLBACK;
 }
+/**
+ * Load the dictionary serving `locale`. Resolves `true` once it is available
+ * (immediately for English or one already loaded), `false` if it failed to load
+ * — `translate` then keeps serving English.
+ */
+export function loadLocale(locale) {
+    const key = dictionaryFor(locale);
+    if (DICTS[key])
+        return Promise.resolve(true);
+    let load = pending.get(key);
+    if (!load) {
+        load = LOADERS[key]()
+            .then((mod) => {
+            DICTS[key] = mod.default;
+            version++;
+            for (const listener of listeners)
+                listener();
+            return true;
+        })
+            .catch(() => false)
+            .finally(() => pending.delete(key));
+        pending.set(key, load);
+    }
+    return load;
+}
+/** Whether the dictionary serving `locale` is loaded (English always is). */
+export function isLocaleLoaded(locale) {
+    return Boolean(DICTS[dictionaryFor(locale)]);
+}
+/**
+ * Subscribe to dictionaries finishing loading (for re-rendering once a
+ * language arrives). Returns the unsubscribe. Pair with {@link getLocalesVersion}
+ * in `useSyncExternalStore`.
+ */
+export function subscribeLocales(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+/** Bumps each time a dictionary loads. */
+export function getLocalesVersion() {
+    return version;
+}
+/**
+ * Resolve a locale tag to the LOADED dictionary that should serve it.
+ *
+ * Account locales are full BCP-47 tags (e.g. `es-MX`, `pt-BR`), but a
+ * dictionary is shipped per language: the exact tag, else its base subtag,
+ * else English. A dictionary not loaded yet serves English for now and starts
+ * loading — `subscribeLocales` announces its arrival.
+ */
+function resolveLang(locale) {
+    const key = dictionaryFor(locale);
+    if (DICTS[key])
+        return key;
+    void loadLocale(key);
+    return FALLBACK;
+}
 function getNested(obj, path) {
-    return path.split('.').reduce((acc, key) => (acc && acc[key] != null ? acc[key] : undefined), obj);
+    return path.split('.').reduce((acc, key) => (acc && typeof acc === 'object' && acc[key] != null ? acc[key] : undefined), obj);
 }
 export function translate(locale, key, vars) {
     const lang = resolveLang(locale);
@@ -69,13 +110,13 @@ export function translate(locale, key, vars) {
     }
     if (typeof val !== 'string')
         return key; // last resort: echo the key when truly absent everywhere
+    let text = val;
     if (vars) {
-        Object.keys(vars).forEach(k => {
-            const token = `{{${k}}}`;
-            val = val.replaceAll(token, String(vars[k]));
-        });
+        for (const k of Object.keys(vars)) {
+            text = text.split(`{{${k}}}`).join(String(vars[k]));
+        }
     }
-    return val;
+    return text;
 }
 export function hasKey(locale, key) {
     const lang = resolveLang(locale);

package/dist/esm/i18n/locales/{ar-SA.json → ar-SA.js}

@@ -1,14 +1,9 @@
-{
+const dict = {
     "signin": {
         "title": "تسجيل الدخول",
         "subtitle": "استخدم حسابك في Oxy",
         "addAccountTitle": "إضافة حساب آخر",
         "addAccountSubtitle": "تسجيل الدخول بحساب آخر",
-        "username": {
-            "label": "اسم المستخدم",
-            "placeholder": "yourname",
-            "required": "يرجى إدخال اسم المستخدم."
-        },
         "actions": {
             "continue": "متابعة",
             "back": "رجوع"
@@ -23,16 +18,25 @@
             "caption": "امسح باستخدام Commons لتسجيل الدخول",
             "renew": "عرض رمز جديد"
         },
-        "methods": {
-            "passkey": "تسجيل الدخول بمفتاح المرور"
-        },
         "errors": {
             "rateLimited": "محاولات كثيرة جدًا. حاول مرة أخرى بعد {{seconds}} ث.",
-            "passkeyCancelled": "تم إغلاق طلب مفتاح المرور. حاول مرة أخرى عندما تكون مستعدًا.",
-            "passkeyFailed": "تعذر إكمال مفتاح المرور. حاول مرة أخرى."
+            "invalidCredentials": "اسم المستخدم أو البريد الإلكتروني أو كلمة المرور غير صحيح.",
+            "codeInvalid": "الرمز غير صحيح أو انتهت صلاحيته.",
+            "requestExpired": "انتهت صلاحية تسجيل الدخول هذا. أرسل رسالة جديدة.",
+            "secondFactorInvalid": "الرمز غير صحيح. جرّب الرمز الحالي.",
+            "originNotAllowed": "تسجيل الدخول غير متاح هنا.",
+            "generic": "حدث خطأ ما. يُرجى المحاولة مرة أخرى.",
+            "notConfigured": "تسجيل الدخول غير متاح",
+            "notConfiguredDescription": "لم يُعدّ {{app}} لتسجيل الدخول بعد. تواصل مع مطوّر التطبيق.",
+            "failed": "تعذّر بدء تسجيل الدخول",
+            "failedDescription": "حدث خطأ ما. يُرجى المحاولة مرة أخرى."
         },
         "chooser": {
-            "subtitleToApp": "للمتابعة إلى {{app}}"
+            "subtitleToApp": "للمتابعة إلى {{app}}",
+            "title": "اختر حسابًا",
+            "subtitle": "تابع بأحد الحسابات أدناه، أو استخدم حسابًا آخر.",
+            "useAnother": "استخدم حسابًا آخر",
+            "continueAs": "المتابعة باسم {{name}}"
         },
         "terms": {
             "before": "بالمتابعة، أنت توافق على",
@@ -42,15 +46,52 @@
         },
         "noAccount": "ليس لديك حساب؟",
         "createAccount": "إنشاء حساب",
-        "recoverLink": "فقدت مفتاح المرور؟ استرد حسابك"
+        "identifier": {
+            "label": "البريد الإلكتروني أو اسم المستخدم",
+            "placeholder": "you@example.com",
+            "required": "أدخل بريدك الإلكتروني أو اسم المستخدم."
+        },
+        "checkEmail": {
+            "title": "تحقق من بريدك",
+            "description": "إذا كان هناك حساب يطابق {{identifier}}، فقد أرسلنا إليه رمزًا ورابطًا لتسجيل الدخول.",
+            "codeLabel": "الرمز",
+            "codeHint": "اكتب الرمز الوارد في الرسالة، أو افتح رابطها في هذا المتصفح.",
+            "resend": "أرسل رسالة جديدة",
+            "resendIn": "أرسل رسالة جديدة بعد {{seconds}} ث",
+            "resent": "أرسلنا رسالة جديدة.",
+            "retryLater": "أرسلنا عدة رسائل بالفعل. انتظر بضع دقائق ثم حاول مرة أخرى.",
+            "usePassword": "استخدم كلمة المرور بدلًا من ذلك",
+            "differentAccount": "استخدم حسابًا آخر"
+        },
+        "password": {
+            "title": "أدخل كلمة المرور",
+            "label": "كلمة المرور",
+            "required": "أدخل كلمة المرور.",
+            "forgot": "نسيتها؟ احصل على رمز عبر البريد"
+        },
+        "secondFactor": {
+            "title": "التحقق بخطوتين",
+            "description": "أدخل الرمز من تطبيق المصادقة.",
+            "backupDescription": "أدخل أحد رموزك الاحتياطية. يعمل كل رمز مرة واحدة فقط.",
+            "label": "رمز المصادقة",
+            "backupLabel": "رمز احتياطي",
+            "useBackup": "استخدم رمزًا احتياطيًا",
+            "useAuthenticator": "استخدم تطبيق المصادقة"
+        },
+        "link": {
+            "approvedTitle": "سجّلت الدخول",
+            "approvedDescription": "ارجع إلى التطبيق الذي طلبت منه تسجيل الدخول: سيتابع تلقائيًا. يمكنك إغلاق علامة التبويب هذه.",
+            "otherDeviceTitle": "افتح الرابط في المتصفح نفسه",
+            "otherDeviceDescription": "يعمل هذا الرابط فقط في المتصفح الذي طلبت منه تسجيل الدخول. افتحه هناك، أو اكتب الرمز الوارد في الرسالة داخل التطبيق.",
+            "invalidTitle": "لا يمكن استخدام هذا الرابط",
+            "invalidDescription": "انتهت صلاحيته أو استُخدم من قبل. اطلب رسالة جديدة من التطبيق، أو اكتب الرمز الوارد في أحدث رسالة."
+        }
     },
     "signup": {
         "title": "أنشئ حسابك",
-        "subtitle": "هوية واحدة لكل النظام البيئي.",
-        "createInCommons": "أنشئ هويتك في Commons",
-        "createAccount": "إنشاء حساب",
+        "subtitle": "اختر اسم المستخدم. ثم نؤكد بريدك الإلكتروني.",
+        "createInCommons": "أنشئها في Commons بدلًا من ذلك",
         "backToSignInLink": "لديك حساب بالفعل؟ سجّل الدخول",
-        "webSubtitle": "بلا كلمة مرور: ينشئ جهازك مفتاح مرور، ويعيدك بريد الاسترداد إذا فقدته.",
         "username": {
             "label": "اسم المستخدم",
             "placeholder": "yourname",
@@ -58,25 +99,20 @@
             "taken": "اسم المستخدم هذا مستخدم بالفعل."
         },
         "email": {
-            "title": "بريد الاسترداد",
-            "subtitle": "إذا فقدت مفتاح المرور، نرسل إلى هنا رمزًا لتعود. لا يُستخدم لأي شيء آخر.",
+            "title": "ما بريدك الإلكتروني؟",
+            "subtitle": "تسجّل الدخول به: نرسل إليك رمزًا في كل مرة. لا يراه أحد غيرك.",
             "label": "البريد الإلكتروني",
             "placeholder": "you@example.com",
             "invalid": "أدخل بريدًا إلكترونيًا صالحًا."
         },
-        "passkey": {
-            "title": "أنشئ مفتاح المرور",
-            "subtitle": "تسجّل الدخول به: ببصمتك أو وجهك أو قفل الشاشة. لا شيء تتذكره.",
-            "action": "إنشاء مفتاح مرور"
-        },
-        "commonsInstead": "تريد الاحتفاظ بمفتاحك بنفسك؟ استخدم Commons"
+        "commonsSubtitle": "أو أنشئ هويتك في Commons واحتفظ بمفتاحك بنفسك.",
+        "laterNote": "يمكنك لاحقًا إضافة كلمة مرور أو تطبيق مصادقة من إعدادات الأمان في حسابك."
     },
     "accountSwitcher": {
         "loading": "جارٍ تحميل الحسابات...",
         "qrHeadline": "سجّل الدخول بهوية Oxy الخاصة بك",
         "signInWithOxy": "تسجيل الدخول باستخدام Oxy",
         "signUpWithOxy": "التسجيل باستخدام Oxy",
-        "useIdentityOnDevice": "لا تملك Commons؟ استخدم مفتاح مرور على هذا الجهاز بدلاً من ذلك",
         "getCommons": "احصل على Commons",
         "commonsNotInstalled": "لا تملك Commons؟ احصل على التطبيق لتسجيل الدخول بمعرّف Oxy الخاص بك.",
         "showQrAnyway": "لدي Commons على جهاز آخر",
@@ -246,26 +282,9 @@
         "privacy": "سياسة الخصوصية",
         "terms": "شروط الخدمة"
     },
-    "recover": {
-        "title": "استرد حسابك",
-        "subtitle": "أدخل اسم المستخدم أو بريد الاسترداد. سنرسل رمزًا إلى بريد الاسترداد الخاص بالحساب.",
-        "identifier": {
-            "label": "اسم المستخدم أو البريد",
-            "placeholder": "yourname",
-            "required": "أدخل اسم المستخدم أو البريد."
-        },
-        "commonsNote": "هل يستخدم حسابك Commons؟ استرده في Commons بعبارة الاسترداد.",
-        "passkey": {
-            "title": "أضف مفتاح مرور جديدًا",
-            "subtitle": "لـ @{{username}}. أزل مفاتيح المرور المفقودة لاحقًا من إعدادات أمان حسابك.",
-            "action": "إنشاء مفتاح مرور"
-        },
-        "backToSignIn": "العودة إلى تسجيل الدخول"
-    },
     "emailCode": {
         "title": "تحقق من بريدك",
         "sentTo": "أرسلنا رمزًا من 6 أرقام إلى {{email}}.",
-        "sentIfAccount": "إذا كان لهذا الحساب بريد استرداد، فقد أرسلنا إليه رمزًا من 6 أرقام.",
         "label": "الرمز",
         "resend": "أرسل رمزًا جديدًا",
         "resent": "أرسلنا رمزًا جديدًا.",
@@ -279,17 +298,20 @@
         }
     },
     "deleteAccount": {
-        "passkey": {
-            "subtitle": "أكّد بمفتاح المرور. سيُحذف @{{username}} وكل ما فيه نهائيًا.",
-            "action": "الحذف بمفتاح المرور",
+        "keyless": {
+            "subtitle": "سيُحذف @{{username}} وكل ما فيه نهائيًا. اكتب اسم المستخدم، ثم أكّد برمز نرسله إلى بريدك.",
+            "action": "حذف الحساب",
             "done": "حُذف حسابك.",
-            "closeWindow": "يمكنك إغلاق هذه النافذة.",
-            "commons": "يستخدم هذا الحساب Commons: احذفه في Oxy Commons من الإعدادات > حذف الحساب، بمفتاحه."
+            "doneDescription": "سُجّل خروجك.",
+            "keyed": "يستخدم هذا الحساب Commons: احذفه في Oxy Commons من الإعدادات > حذف الحساب، بمفتاحه."
+        },
+        "handoff": {
+            "elsewhereMessage": "حذف حسابك يتطلب مفتاح هويتك، وهو غير موجود على هذا الجهاز. افتح Oxy Commons على الجهاز الذي يحتفظ به وانتقل إلى الإعدادات > حذف الحساب."
         }
     },
     "linkCommons": {
         "title": "اربط Commons",
-        "subtitle": "احتفظ بمفتاحك: اربط Commons ليصبح هذا الحساب لك وحدك. يُحذف بريد الاسترداد الخاص به، وتصبح عبارة الاسترداد في Commons طريقك للعودة.",
+        "subtitle": "احتفظ بمفتاحك: اربط Commons ليصبح هذا الحساب لك وحدك. يُحذف بريده الإلكتروني، وتصبح عبارة الاسترداد في Commons طريقك للعودة.",
         "scan": "على هاتفك، افتح Commons واختر «لدي حساب Oxy على الويب» ثم امسح هذا الرمز.",
         "waiting": "بانتظار Commons…",
         "compareTitle": "تحقق من الرمز",
@@ -297,10 +319,68 @@
         "confirm": "نعم، اربط Commons",
         "cancel": "إلغاء",
         "doneTitle": "تم ربط Commons",
-        "done": "أصبح هذا الحساب ذاتي الحفظ. حُذف بريد الاسترداد الخاص به: عبارة الاسترداد في Commons هي طريقك للعودة.",
+        "done": "أصبح هذا الحساب ذاتي الحفظ. حُذف بريده الإلكتروني: عبارة الاسترداد في Commons هي طريقك للعودة.",
         "already": "يستخدم هذا الحساب Commons بالفعل.",
         "expired": "انتهت صلاحية هذا الرمز.",
         "renew": "اعرض رمزًا جديدًا",
-        "failed": "تعذّر ربط Commons. حاول مجددًا."
+        "failed": "تعذّر ربط Commons. حاول مجددًا.",
+        "confirmTitle": "أكّد الربط",
+        "confirmDescription": "للإنهاء، أكّد أنك أنت برمز نرسله إلى بريدك.",
+        "row": "احتفظ بمفتاحك بنفسك مع Commons"
+    },
+    "reauth": {
+        "title": "أكّد أنك أنت",
+        "emailDescription": "سنرسل رمزًا إلى بريدك لتأكيد هذا التغيير.",
+        "sendCode": "أرسل الرمز",
+        "codeSent": "أرسلنا رمزًا من 6 أرقام إلى بريدك.",
+        "codeLabel": "الرمز من الرسالة",
+        "passwordLabel": "كلمة المرور الحالية",
+        "usePassword": "استخدم كلمة المرور بدلًا من ذلك",
+        "useEmail": "احصل على رمز عبر البريد بدلًا من ذلك",
+        "totpLabel": "رمز المصادقة أو الرمز الاحتياطي",
+        "errors": {
+            "invalid": "لم ينجح ذلك. تحقق مما كتبته وحاول مرة أخرى.",
+            "totpRequired": "أدخل أيضًا الرمز من تطبيق المصادقة."
+        }
+    },
+    "signInSecurity": {
+        "password": {
+            "title": "كلمة المرور",
+            "setTitle": "عيّن كلمة مرور",
+            "changeTitle": "غيّر كلمة المرور",
+            "description": "سجّل الدخول بكلمة المرور بدلًا من رمز عبر البريد. استخدم {{min}} أحرف على الأقل.",
+            "newLabel": "كلمة المرور الجديدة",
+            "repeatLabel": "كرّر كلمة المرور",
+            "tooShort": "استخدم {{min}} أحرف على الأقل.",
+            "mismatch": "كلمتا المرور غير متطابقتين.",
+            "signOutOthers": "سجّل الخروج من كل مكان آخر",
+            "save": "احفظ كلمة المرور",
+            "saved": "حُفظت كلمة المرور.",
+            "row": "اختياري: سجّل الدخول بكلمة مرور"
+        },
+        "totp": {
+            "title": "تطبيق المصادقة",
+            "description": "بعد رمز البريد أو كلمة المرور، يطلب Oxy أيضًا رمزًا من تطبيق مثل Google Authenticator أو 1Password.",
+            "setUp": "إعداد",
+            "scan": "امسح رمز QR هذا بتطبيق المصادقة، أو أدخل مفتاح الإعداد.",
+            "secretLabel": "مفتاح الإعداد",
+            "codeLabel": "الرمز من التطبيق",
+            "enable": "تشغيل",
+            "enabled": "تطبيق المصادقة مفعّل.",
+            "disable": "أوقف تطبيق المصادقة",
+            "disabled": "تطبيق المصادقة متوقف.",
+            "on": "مفعّل",
+            "off": "متوقف",
+            "backupTitle": "احفظ رموزك الاحتياطية",
+            "backupDescription": "إذا فقدت هاتفك، فكل رمز يتيح لك تسجيل الدخول مرة واحدة. احفظها في مكان آمن: لن تُعرض مرة أخرى.",
+            "copy": "انسخ الرموز",
+            "copied": "نُسخت الرموز الاحتياطية.",
+            "savedThem": "حفظتها",
+            "regenerate": "احصل على رموز احتياطية جديدة",
+            "regenerateDescription": "ستتوقف رموزك الاحتياطية القديمة عن العمل.",
+            "remaining": "تبقّى {{count}} من الرموز الاحتياطية",
+            "row": "خطوة ثانية عند تسجيل الدخول"
+        }
     }
-}
+};
+export default dict;