Extension Chrome et Firefox pour Synco. Elle a deux rôles, strictement séparés :
- Coffre de clés (
src/vault/) : un type de coffre « extension » pour le chiffrement de bout en bout de Synco. Il ne répond qu'aux origines Synco de la liste blanche (correspondance exacte). Ce n'est pas un gestionnaire de passkeys : aucune interception denavigator.credentials, aucune réponse à d'autres sites. - Actions de page (
src/page-actions/) : intégrations au navigateur valables sur tous les sites (par exemple « Créer une tâche dans Synco » sur une sélection de texte). Ce module n'a jamais accès au coffre. Masqué pour l'instant (aucun menu, aucun onglet) tant que l'envoi à Synco n'est pas branché ; le code reste en place.
État : phase P6 (documentation). Le coffre, le canal page ↔ extension, l'interface (fenêtre d'accord, popup, page d'options) et le squelette des actions de page (menu contextuel, contrat de message) sont en place. Rien n'est encore envoyé à Synco par les actions de page. Les paquets de publication (Chrome, Firefox, source pour l'AMO) se fabriquent avec
node scripts/package.mjs; la recette dans un vrai navigateur est dans doc/recette-manuelle.md. Spécification du coffre et modèle de menace : doc/16-coffre-extension.md.
Même charte que l'application Synco (jetons de couleur, boutons, pastilles, icônes Bootstrap Icons, logo), sombre par défaut et claire selon le système. Elle est modulaire : le coffre, les actions de page et, plus tard, Synco AI ou Tinko sont des modules indépendants qui s'affichent en onglets dans le popup et la page d'options. Principes, composants et marche à suivre pour ajouter un module : doc/interface-modulaire.md.
Elles sont définies dans config/origins.json et injectées dans le manifeste au build :
| Build | Origines |
|---|---|
--prod |
https://app.synco.one |
--dev |
https://localhost:5174 (pour tester depuis une VM, ajouter son origine, ex. https://dev.synco.local:5174, dans config/origins.json) |
Pas de joker ni de sous-domaine implicite. Le paquet de production ne contient aucune origine locale (vérifié au build et par les tests).
Prérequis : Bun (installation et tests) et Node.js 22 ou plus (build et vérification de types). Ne pas lancer tsc ni le build avec Bun.
bun install --frozen-lockfile # versions épinglées par bun.lock
node scripts/build.mjs --prod # → dist/chrome/ et dist/firefox/
node scripts/build.mjs --dev # origines de développement, nom « (dev) »Le build est reproductible : versions exactes, bun.lock versionné, aucun horodatage, aucune minification (le code reste lisible pour la relecture de l'AMO). Il n'y a aucune dépendance d'exécution : seulement des outils de build et de test.
Charger en local : Chrome → chrome://extensions (mode développeur, « Charger l'extension non empaquetée » sur dist/chrome) ; Firefox → about:debugging (« Charger un module complémentaire temporaire » sur dist/firefox/manifest.json), puis, dans about:addons → Autorisations, accorder l'accès au site. Un clic sur l'icône de l'extension ouvre son popup (état, enregistrements, brouillon de tâche) ; la page d'options complète s'ouvre depuis le popup.
Firefox ne gère pas les ports dans les motifs d'URL : son manifeste reçoit un motif sans port (
https://localhost/*en développement). L'origine exacte, port compris, est revérifiée par le content script puis par le worker.
bun test # tests
node node_modules/typescript/bin/tsc --noEmit # types
node scripts/check-secrets.mjs --all # secrets dans les fichiers du dépôt
node scripts/check-deps-age.mjs # dépendances : versions exactes, publiées depuis ≥ 7 jours (réseau)
node scripts/lint-firefox.mjs # addons-linter (moteur de web-ext lint) sur le paquet Firefox
node scripts/make-ui-assets.mjs --check # src/ui/icons.css (icônes, logo) à jourLe dépôt est public : bun run setup active le hook pre-commit qui exécute le contrôle de secrets sur chaque commit.
node scripts/package.mjs # → dist/*.zip (Chrome, Firefox, source) et dist/SHA256SUMS.txtProcédure complète, reconstruction à l'identique pour les relecteurs de l'AMO et notes pour les stores :
doc/build-reproductible.md. Relecteurs AMO : BUILD.md et bash scripts/amo-build.sh.
Une base de code, deux manifestes générés (manifests/base.json + chrome.json ou firefox.json), Manifest V3 des deux côtés :
- Chrome :
background.service_worker(Chrome 121 ou plus). - Firefox :
background.scripts(page événementielle) etbrowser_specific_settings.gecko(identifiant obligatoire,data_collection_permissionsobligatoire pour les nouvelles soumissions AMO, Firefox 140 ou plus).
Voir SECURITY.md et le modèle de menace détaillé : doc/16-coffre-extension.md.
Tous droits réservés, voir LICENSE. Le code est public à des fins de transparence uniquement.