@salifbiaye/create-boutique 0.6.0 → 0.7.1

package/cli/dist/index.js

@@ -3,7 +3,7 @@ import fs from "node:fs";
 import { parseArgs } from "node:util";
 import pc from "picocolors";
 import { z } from "zod";
-import { add, admin, apply, urls, backup, campaignExport, campaignImport, check, guide, remove, set, stripeWebhook, themes, update } from "./commands.js";
+import { add, admin, apply, urls, backup, restore, campaignExport, campaignImport, check, guide, remove, set, stripeWebhook, themes, update } from "./commands.js";
 import { answersSchema, create } from "./create.js";
 import { ProjectError } from "./project.js";
 const HELP = `create-boutique — Usine à Boutiques
@@ -18,7 +18,9 @@ const HELP = `create-boutique — Usine à Boutiques
     --site-url <domaine>      mode single : domaine du site
     --mode multi|single       multi (défaut) : un site par boutique ; single : un seul site, boutique active choisie dans l'admin
     --stripe-pk / --stripe-sk / --stripe-whsec   clés Stripe (optionnelles)
-    --resend-key / --email-from                  e-mails (optionnels)
+    --resend-key / --email-from                  e-mails par Resend (optionnels)
+    --smtp-host smtp.gmail.com --smtp-user <adresse>   e-mails par SMTP (mot de passe : SMTP_PASS dans .env)
+    --mobile paytech,paydunya,naboopay           paiement Wave / Orange Money (clés dans .env ; détails : create-boutique sans --yes)
     --products <csv>  --images <dossier>         catalogue (optionnel)
     --store-port 8001  --api-port 9000  --storage-port 9100   premiers ports essayés
     --config <fichier.json>   toutes les options dans un fichier (mêmes clés, en camelCase)
@@ -32,16 +34,18 @@ const HELP = `create-boutique — Usine à Boutiques
   create-boutique set <dossier> [--mode multi|single]   change de mode (un site par boutique ↔ un seul site)
   create-boutique set <dossier> [--boutique <slug>] [--name …] [--theme …] [--currency …] [--country …] [--language …]
   create-boutique themes                           liste les thèmes
-  create-boutique update <dossier> [--no-up]       met à jour le code (config, .env, données conservés)
+  create-boutique update <dossier> [--no-up] [--yes]   met à jour le code (config, .env, données, custom.css conservés ;
+                                                   code modifié à la main : listé, copié dans backups/, confirmation)
   create-boutique check <dossier>                  commande test dans chaque boutique
-  create-boutique backup <dossier>                 base + images dans backups/<date>/
+  create-boutique backup <dossier> [--keep 7]      base + images dans backups/<date>/ (--keep : garde les N plus récentes)
+  create-boutique restore <dossier> [--from <nom>] [--yes]   remet une sauvegarde (la plus récente par défaut)
   create-boutique admin <dossier>                  adresse, e-mail et mot de passe de l'admin
   create-boutique guide <dossier>                  régénère GUIDE-CLIENT.pdf et GUIDE-COMPLET.pdf
   create-boutique stripe-webhook <dossier> --url https://api.marque.com   crée le webhook Stripe, écrit STRIPE_WEBHOOK_SECRET
   create-boutique campaign export <dossier>        campagnes en base → config/campaigns/*.json
   create-boutique campaign import <dossier> [--boutique <slug>] [--yes]   JSON → base (écrase)
 `;
-const COMMANDS = new Set(["urls", "apply", "add", "remove", "set", "themes", "update", "check", "backup", "campaign", "admin", "guide", "stripe-webhook", "help"]);
+const COMMANDS = new Set(["restore", "urls", "apply", "add", "remove", "set", "themes", "update", "check", "backup", "campaign", "admin", "guide", "stripe-webhook", "help"]);
 async function main() {
     const { values, positionals } = parseArgs({
         allowPositionals: true,
@@ -59,11 +63,15 @@ async function main() {
             "files-url": { type: "string" },
             "site-url": { type: "string" },
             from: { type: "string" },
+            keep: { type: "string" },
             "stripe-pk": { type: "string" },
             "stripe-sk": { type: "string" },
             "stripe-whsec": { type: "string" },
             "resend-key": { type: "string" },
             "email-from": { type: "string" },
+            "smtp-host": { type: "string" },
+            "smtp-user": { type: "string" },
+            mobile: { type: "string" },
             products: { type: "string" },
             images: { type: "string" },
             "store-port": { type: "string" },
@@ -108,6 +116,9 @@ async function main() {
             stripeWhsec: values["stripe-whsec"],
             resendKey: values["resend-key"],
             emailFrom: values["email-from"],
+            smtpHost: values["smtp-host"],
+            smtpUser: values["smtp-user"],
+            mobile: values.mobile ? values.mobile.split(",").map((m) => m.trim()).filter(Boolean) : undefined,
             products: values.products,
             images: values.images,
             storePort: port(values["store-port"]),
@@ -140,11 +151,13 @@ async function main() {
         case "themes":
             return themes();
         case "update":
-            return update(dirArg(), up);
+            return update(dirArg(), { ...up, yes: !!values.yes });
         case "check":
             return check(dirArg());
         case "backup":
-            return backup(dirArg());
+            return void backup(dirArg(), { keep: values.keep ? Number(values.keep) : undefined });
+        case "restore":
+            return restore(dirArg(), { from: values.from, yes: !!values.yes });
         case "admin":
             return admin(dirArg());
         case "guide":

package/cli/dist/payments.js

@@ -0,0 +1,150 @@
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+export const MOBILE = {
+    paytech: {
+        name: "PayTech",
+        methods: "Wave, Orange Money, Free Money, Wizall, carte bancaire (Visa, Mastercard)",
+        currencies: ["xof", "eur", "usd", "cad", "gbp", "mad"],
+        test: "pas de simulation : chaque paiement test débite vraiment 100 à 150 FCFA (quel que soit le panier) sur le Wave / Orange Money du testeur ; l'argent arrive sur le solde PayTech de la boutique (moins les frais)",
+        needs: "compte PayTech + 2 clés (API_KEY, API_SECRET) ; mode prod après activation du compte",
+        refund: "bouton Remboursement de l'admin : l'argent repart vers le client (remboursement total uniquement)",
+        site: "paytech.sn",
+    },
+    paydunya: {
+        name: "PayDunya",
+        methods: "Wave, Orange Money, Free Money, carte bancaire…",
+        currencies: ["xof"],
+        test: "sandbox gratuite (aucun vrai paiement), clés de test séparées",
+        needs: "compte PayDunya + application + 3 clés (master key, private key, token)",
+        refund: "dans le tableau de bord PayDunya (pas d'API), puis enregistré dans l'admin",
+        site: "paydunya.com",
+    },
+    naboopay: {
+        name: "NabooPay",
+        methods: "Wave, Orange Money (carte annoncée)",
+        currencies: ["xof"],
+        test: "pas de mode test documenté : tester avec de petits montants réels",
+        needs: "compte NabooPay + 1 clé API + secret du webhook (tableau de bord → Paramètres → Intégration)",
+        refund: "bouton Remboursement de l'admin : l'argent repart vers le client (total uniquement, Wave et Orange Money)",
+        site: "naboopay.com",
+    },
+};
+const stop = (v) => {
+    if (p.isCancel(v)) {
+        p.cancel("Création annulée.");
+        process.exit(1);
+    }
+    return v;
+};
+/** Devises des boutiques pour lesquelles l'agrégateur ne s'affichera pas */
+const unsupported = (id, currencies) => currencies.filter((c) => !MOBILE[id].currencies.includes(c));
+/** Explication affichée avant le choix : critères de chaque agrégateur */
+export function mobileNote(currencies) {
+    const lines = Object.keys(MOBILE).flatMap((id) => {
+        const m = MOBILE[id];
+        const off = unsupported(id, currencies);
+        return [
+            pc.bold(`${m.name}`) + pc.dim(`  (${m.site})`),
+            `  Moyens     : ${m.methods}`,
+            `  Devises    : ${m.currencies.map((c) => c.toUpperCase()).join(", ")}` + (off.length ? pc.yellow(`  → pas pour vos boutiques en ${off.join(", ").toUpperCase()}`) : ""),
+            `  Test       : ${m.test}`,
+            `  Il faut    : ${m.needs}`,
+            `  Rembourser : ${m.refund}`,
+            "",
+        ];
+    });
+    return [
+        "Le client choisit « Wave, Orange Money… », paie sur la page sécurisée de l'agrégateur,",
+        "puis revient sur la boutique ; le montant est toujours calculé par le backend.",
+        "Confirmation automatique (même si le client ferme la page) : backend en ligne en HTTPS.",
+        "",
+        ...lines,
+        "Plusieurs possibles (le client voit un choix par agrégateur). Clés : maintenant (saisie masquée)",
+        "ou plus tard dans .env, puis « docker compose restart backend ».",
+    ].join("\n");
+}
+/** Questions : agrégateurs, clés (facultatives maintenant), mode test / prod */
+export async function askMobile(a, currencies) {
+    if (a.mobile)
+        return a;
+    p.note(mobileNote(currencies), "Paiement mobile : Wave, Orange Money, carte (Afrique de l'Ouest)");
+    const mobile = stop(await p.multiselect({
+        message: "Agrégateurs de paiement mobile (espace = cocher, Entrée sans rien = aucun)",
+        options: Object.keys(MOBILE).map((id) => {
+            const off = unsupported(id, currencies);
+            return {
+                value: id,
+                label: MOBILE[id].name,
+                hint: `${MOBILE[id].currencies.length > 1 ? "XOF, EUR, USD…" : "XOF uniquement"}${off.length ? ` · inactif en ${off.join(", ").toUpperCase()}` : ""}`,
+            };
+        }),
+        required: false,
+    }));
+    for (const id of mobile) {
+        const off = unsupported(id, currencies);
+        if (off.length === currencies.length) {
+            p.log.warn(`${MOBILE[id].name} n'acceptera aucune de vos boutiques (${currencies.join(", ").toUpperCase()}) : il faut une boutique en XOF.`);
+        }
+    }
+    const out = { mobile };
+    const secret = async (message) => stop(await p.password({ message: `${message} (vide = plus tard dans .env)` })) || undefined;
+    const env = async (name, test) => stop(await p.select({
+        message: `${name} : mode`,
+        options: [
+            { value: "test", label: "test", hint: test },
+            { value: "prod", label: "production", hint: "vrais paiements, compte activé" },
+        ],
+        initialValue: "test",
+    }));
+    if (mobile.includes("paytech")) {
+        out.paytechKey = await secret("PayTech : API_KEY");
+        out.paytechSecret = out.paytechKey ? await secret("PayTech : API_SECRET") : undefined;
+        out.paytechEnv = await env("PayTech", "vrais débits de 100 à 150 FCFA par paiement test, reçus sur le solde PayTech");
+    }
+    if (mobile.includes("paydunya")) {
+        out.paydunyaMaster = await secret("PayDunya : clé principale (master key)");
+        out.paydunyaPrivate = out.paydunyaMaster ? await secret("PayDunya : clé privée") : undefined;
+        out.paydunyaToken = out.paydunyaMaster ? await secret("PayDunya : token") : undefined;
+        out.paydunyaEnv = await env("PayDunya", "sandbox, aucun vrai paiement");
+    }
+    if (mobile.includes("naboopay")) {
+        out.naboopayKey = await secret("NabooPay : clé API");
+        p.log.info("NabooPay : le secret du webhook se crée après la mise en ligne (tableau de bord → Paramètres → Intégration) ; à mettre dans NABOOPAY_WEBHOOK_SECRET.");
+    }
+    return out;
+}
+/** Ligne du récapitulatif */
+export function mobileSummary(a) {
+    if (!a.mobile?.length)
+        return "Wave / Orange Money : non (possible plus tard : clés dans .env, voir README)";
+    const one = (id) => {
+        const keys = id === "paytech" ? a.paytechKey && a.paytechSecret : id === "paydunya" ? a.paydunyaMaster && a.paydunyaPrivate && a.paydunyaToken : a.naboopayKey;
+        const mode = id === "paytech" ? a.paytechEnv : id === "paydunya" ? a.paydunyaEnv : undefined;
+        return `${MOBILE[id].name}${mode ? ` (${mode})` : ""}${keys ? "" : " — clés à mettre dans .env"}`;
+    };
+    return `Wave / Orange Money : ${a.mobile.map(one).join(", ")}`;
+}
+/** E-mails : Resend, SMTP (Gmail…) ou aucun */
+export async function askMail() {
+    const kind = stop(await p.select({
+        message: "E-mails aux clients (confirmation, expédition, mot de passe oublié…)",
+        options: [
+            { value: "smtp", label: "SMTP (Gmail, OVH, Brevo…)", hint: "Gmail : mot de passe d'application, ~500 e-mails/jour" },
+            { value: "resend", label: "Resend", hint: "clé re_…, domaine vérifié ; 3 000 e-mails/mois gratuits" },
+            { value: "none", label: "Aucun pour l'instant", hint: "la boutique marche, sans e-mails" },
+        ],
+        initialValue: "smtp",
+    }));
+    if (kind !== "smtp")
+        return { kind };
+    p.note([
+        "Gmail : Compte Google → Sécurité → Validation en deux étapes (activée)",
+        "→ Mots de passe des applications → créer (16 caractères). Jamais le mot de passe du compte.",
+        "Les e-mails partent de l'adresse Gmail, avec le nom de la boutique ; les réponses vont au marchand.",
+    ].join("\n"), "SMTP");
+    const host = stop(await p.text({ message: "Serveur SMTP", initialValue: "smtp.gmail.com" }));
+    const port = Number(stop(await p.text({ message: "Port (465 = SSL, 587 = STARTTLS)", initialValue: "465", validate: (v) => (/^\d+$/.test(v ?? "") ? undefined : "un nombre") })));
+    const user = stop(await p.text({ message: "Identifiant (adresse e-mail du compte)", placeholder: "boutique@gmail.com" }));
+    const pass = stop(await p.password({ message: "Mot de passe d'application (vide = plus tard dans .env)" })) || undefined;
+    return { kind, smtp: { smtpHost: host.trim(), smtpPort: port, smtpUser: user.trim() || undefined, smtpPass: pass } };
+}

package/docs/fiche-client.en.html

@@ -98,8 +98,8 @@
     <div class="screen">
       <div class="num">3</div>
       <div>
-        <h2>Campaigns <small>texts and images of each store</small></h2>
-        <div class="where">Menu: Campaigns</div>
+        <h2>My stores <small>texts and images of each store</small></h2>
+        <div class="where">Menu: My stores</div>
         <ol>
           <li>Pick the store (Halloween, Black Friday, Christmas…) and click <b>Edit</b>.</li>
           <li>Change the title, text, button, hero image, logo and the offer dates.</li>

package/docs/fiche-client.html

@@ -98,8 +98,8 @@
     <div class="screen">
       <div class="num">3</div>
       <div>
-        <h2>Campagnes <small>textes et images de chaque boutique</small></h2>
-        <div class="where">Menu : Campagnes</div>
+        <h2>Mes boutiques <small>site en ligne ou fermé, textes et images</small></h2>
+        <div class="where">Menu : Mes boutiques</div>
         <ol>
           <li>Choisissez la boutique (Halloween, Black Friday, Noël…) et cliquez sur <b>Modifier</b>.</li>
           <li>Changez le titre, le texte, le bouton, l'image principale, le logo et les dates de l'offre.</li>