@salifbiaye/create-boutique 0.5.0 → 0.7.0

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/cli/dist/project.js

@@ -16,8 +16,14 @@ export const projectSchema = z.object({
     templateVersion: z.string().optional(),
     apiPort: z.number().int().min(1).max(65535).default(9000),
     storagePort: z.number().int().min(1).max(65535).default(9100),
-    /** Production : adresses publiques (https) du backend/admin et des images. Présent = Caddy + https dans le compose. */
+    /** Production : adresses publiques (https) du backend/admin et des images. Présent = ports sur 127.0.0.1 (ton reverse proxy les expose), Caddyfile.exemple fourni. */
     urls: z.strictObject({ api: z.url(), files: z.url() }).optional(),
+    /**
+     * multi (défaut) : un site par boutique, toutes en ligne (1 container, 1 port, 1 domaine chacune).
+     * single : un seul site (site.port, site.url) qui affiche la boutique active, choisie dans admin → Campagnes.
+     */
+    mode: z.enum(["multi", "single"]).default("multi"),
+    site: z.strictObject({ port: z.number().int().min(1).max(65535), url: z.url().optional() }).optional(),
     defaults: z.looseObject({
         storeName: z.string().min(1).max(60),
         currency: code3,
@@ -31,7 +37,8 @@ export const projectSchema = z.object({
         .array(z.strictObject({
         slug: z.string().regex(SLUG, "slug : minuscules, chiffres et tirets"),
         theme: z.string(),
-        port: z.number().int().min(1).max(65535),
+        /** Mode multi : port du site de la boutique (inutile en mode single) */
+        port: z.number().int().min(1).max(65535).optional(),
         url: z.url().optional(),
         storeName: z.string().min(1).max(60).optional(),
         currency: code3.optional(),
@@ -59,7 +66,13 @@ export function validateProject(raw) {
     for (const b of p.boutiques)
         if (!themes.includes(b.theme))
             errors.push(`${b.slug} : thème inconnu « ${b.theme} » (disponibles : ${themes.join(", ")})`);
-    const ports = [p.apiPort, p.storagePort, ...p.boutiques.map((b) => b.port)];
+    if (p.mode === "single" && !p.site)
+        errors.push("mode single : bloc site { port } obligatoire");
+    if (p.mode === "multi")
+        for (const b of p.boutiques)
+            if (!b.port)
+                errors.push(`${b.slug} : port obligatoire (mode multi)`);
+    const ports = [p.apiPort, p.storagePort, ...storePorts(p)];
     for (const port of new Set(ports))
         if (ports.filter((x) => x === port).length > 1)
             errors.push(`port utilisé deux fois : ${port}`);
@@ -119,3 +132,29 @@ export function writeJsonSchema(dir) {
     const schema = z.toJSONSchema(projectSchema, { io: "input", unrepresentable: "any" });
     fs.writeFileSync(path.join(dir, "config", "project.schema.json"), JSON.stringify(schema, null, 2) + "\n");
 }
+/**
+ * Adresse publique saisie par l'utilisateur → origine seule (https://images.marque.com).
+ * Accepte « images.marque.com », une barre finale ou « /medusa » (ajouté ensuite par le CLI pour S3_FILE_URL).
+ */
+export function normalizeUrl(v, what) {
+    const raw = /^https?:\/\//.test(v.trim()) ? v.trim() : `https://${v.trim()}`;
+    let u;
+    try {
+        u = new URL(raw);
+    }
+    catch {
+        throw new ProjectError(`${what} : adresse invalide « ${v} » (ex. https://images.marque.com)`);
+    }
+    const path = u.pathname.replace(/\/+$/, "").replace(/\/medusa$/, "");
+    if (path)
+        throw new ProjectError(`${what} : donnez seulement le domaine (ex. https://images.marque.com), sans chemin « ${u.pathname} »`);
+    return u.origin;
+}
+export function fronts(p) {
+    if (p.mode === "single")
+        return p.site ? [{ service: "storefront", boutique: "auto", port: p.site.port, url: p.site.url }] : [];
+    return p.boutiques.filter((b) => b.port).map((b) => ({ service: `storefront-${b.slug}`, boutique: b.slug, port: b.port, url: b.url }));
+}
+export const storePorts = (p) => fronts(p).map((f) => f.port);
+/** Adresse publique d'une boutique (en mode single : celle du site unique). */
+export const boutiqueUrl = (p, b) => p.mode === "single" ? (p.site?.url ?? `http://localhost:${p.site?.port}`) : (b.url ?? `http://localhost:${b.port}`);

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>