Skip to content

About

synco browser extension

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Synco Extension

Extension Chrome et Firefox pour Synco. Elle a deux rôles, strictement séparés :

  1. 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 de navigator.credentials, aucune réponse à d'autres sites.
  2. 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.

Interface

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.

Origines autorisées

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).

Construire

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.

Vérifications

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) à jour

Le dépôt est public : bun run setup active le hook pre-commit qui exécute le contrôle de secrets sur chaque commit.

Publier

node scripts/package.mjs     # → dist/*.zip (Chrome, Firefox, source) et dist/SHA256SUMS.txt

Procé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.

Compatibilité

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) et browser_specific_settings.gecko (identifiant obligatoire, data_collection_permissions obligatoire pour les nouvelles soumissions AMO, Firefox 140 ou plus).

Sécurité

Voir SECURITY.md et le modèle de menace détaillé : doc/16-coffre-extension.md.

Licence

Tous droits réservés, voir LICENSE. Le code est public à des fins de transparence uniquement.

About

synco browser extension

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages