create-snapify-app 0.0.0-stage → 1.1.1

package/template/modules/recaptcha/snapify.module.json

@@ -0,0 +1,99 @@
+{
+  "id": "hamdiayari.recaptcha",
+  "name": "Google reCAPTCHA",
+  "version": "1.0.0",
+  "description": "Protégez vos formulaires de contact contre le spam et les robots avec Google reCAPTCHA v2 ou v3. Configurez vos clés site et secrète depuis l’administration ; le widget s’affiche automatiquement sur les formulaires du site.",
+  "author": {
+    "name": "Hamdi Ayari",
+    "email": "hamdi.ayari@novalabs.tn",
+    "url": "https://novalabs.tn"
+  },
+  "pricing": "paid",
+  "category": "Contact",
+  "icon": "shield-check",
+  "screenshot": "screenshot.jpg",
+  "engines": {
+    "snapify": "^1.3.0"
+  },
+  "permissions": [
+    "http:routes",
+    "net:www.google.com"
+  ],
+  "slots": [
+    "floating"
+  ],
+  "entries": {
+    "public": "src/public/index.tsx",
+    "server": "src/server.ts"
+  },
+  "settings": [
+    {
+      "key": "enabled",
+      "type": "boolean",
+      "group": "Activation",
+      "label": "Activer reCAPTCHA sur les formulaires",
+      "default": true,
+      "public": true
+    },
+    {
+      "key": "version",
+      "type": "select",
+      "group": "Activation",
+      "label": "Version",
+      "default": "v2",
+      "public": true,
+      "options": [
+        {
+          "value": "v2",
+          "label": "reCAPTCHA v2 (case à cocher)"
+        },
+        {
+          "value": "v3",
+          "label": "reCAPTCHA v3 (score invisible)"
+        }
+      ]
+    },
+    {
+      "key": "siteKey",
+      "type": "text",
+      "group": "Clés Google",
+      "label": "Clé du site (Site key)",
+      "help": "Visible par les visiteurs. Obtenez-la sur https://www.google.com/recaptcha/admin",
+      "default": "",
+      "public": true,
+      "maxLength": 120,
+      "placeholder": "6Lc…"
+    },
+    {
+      "key": "secretKey",
+      "type": "text",
+      "group": "Clés Google",
+      "label": "Clé secrète (Secret key)",
+      "help": "Conservée uniquement sur le serveur. Jamais exposée aux visiteurs.",
+      "default": "",
+      "maxLength": 120,
+      "placeholder": "6Lc…"
+    },
+    {
+      "key": "v3Action",
+      "type": "text",
+      "group": "reCAPTCHA v3",
+      "label": "Action v3",
+      "help": "Nom d’action envoyé à Google (ex. contact).",
+      "default": "contact",
+      "public": true,
+      "maxLength": 40
+    },
+    {
+      "key": "v3MinScore",
+      "type": "number",
+      "group": "reCAPTCHA v3",
+      "label": "Score minimum (0–1)",
+      "help": "En dessous de ce score, l’envoi est refusé. 0,5 est un bon départ.",
+      "default": 0.5,
+      "min": 0,
+      "max": 1
+    }
+  ],
+  "priceMillimes": 49000
+}

package/template/modules/recaptcha/src/public/index.tsx

@@ -0,0 +1,94 @@
+/**
+ * Snapify — module Google reCAPTCHA
+ * © 2026 Hamdi Ayari — hamdi.ayari@novalabs.tn
+ */
+import { useEffect } from 'react';
+import { definePublicModule, type PublicModuleProps } from '@snapify/sdk';
+import type { Settings } from '../types';
+
+declare global {
+  interface Window {
+    grecaptcha?: {
+      ready: (cb: () => void) => void;
+      render: (el: HTMLElement, opts: Record<string, unknown>) => number;
+      getResponse: (id?: number) => string;
+      reset: (id?: number) => void;
+      execute: (siteKey: string, opts: { action: string }) => Promise<string>;
+    };
+    __snapifyRecaptcha?: {
+      siteKey: string;
+      version: 'v2' | 'v3';
+      action: string;
+      getToken: () => Promise<string>;
+    };
+  }
+}
+
+const SCRIPT_ID = 'snapify-recaptcha-script';
+
+function loadScript(siteKey: string, version: 'v2' | 'v3') {
+  if (document.getElementById(SCRIPT_ID)) return;
+  const s = document.createElement('script');
+  s.id = SCRIPT_ID;
+  s.async = true;
+  s.defer = true;
+  s.src =
+    version === 'v3'
+      ? `https://www.google.com/recaptcha/api.js?render=${encodeURIComponent(siteKey)}`
+      : 'https://www.google.com/recaptcha/api.js?render=explicit';
+  document.head.appendChild(s);
+}
+
+function RecaptchaBoot({ settings, isPreview }: PublicModuleProps<Settings>) {
+  useEffect(() => {
+    if (isPreview) return;
+    if (!settings.enabled || !settings.siteKey?.trim()) {
+      delete window.__snapifyRecaptcha;
+      return;
+    }
+    const siteKey = settings.siteKey.trim();
+    const version = settings.version === 'v3' ? 'v3' : 'v2';
+    const action = (settings.v3Action || 'contact').slice(0, 40);
+    loadScript(siteKey, version);
+
+    window.__snapifyRecaptcha = {
+      siteKey,
+      version,
+      action,
+      getToken: () =>
+        new Promise((resolve, reject) => {
+          const wait = (n = 0) => {
+            if (!window.grecaptcha) {
+              if (n > 40) return reject(new Error('reCAPTCHA indisponible'));
+              return setTimeout(() => wait(n + 1), 100);
+            }
+            window.grecaptcha!.ready(() => {
+              if (version === 'v3') {
+                window
+                  .grecaptcha!.execute(siteKey, { action })
+                  .then(resolve)
+                  .catch(() => reject(new Error('reCAPTCHA v3 impossible')));
+              } else {
+                const token = window.grecaptcha!.getResponse();
+                if (!token) reject(new Error('Cochez la case « Je ne suis pas un robot ».'));
+                else resolve(token);
+              }
+            });
+          };
+          wait();
+        }),
+    };
+
+    return () => {
+      delete window.__snapifyRecaptcha;
+    };
+  }, [settings.enabled, settings.siteKey, settings.version, settings.v3Action, isPreview]);
+
+  return null;
+}
+
+export default definePublicModule<Settings>({
+  slots: {
+    floating: RecaptchaBoot,
+  },
+});

package/template/modules/recaptcha/src/server.ts

@@ -0,0 +1,65 @@
+/**
+ * Snapify — module Google reCAPTCHA
+ * © 2026 Hamdi Ayari — hamdi.ayari@novalabs.tn
+ */
+import { defineServerModule, type ServerContext } from '@snapify/sdk';
+import type { Settings } from './types';
+
+export default defineServerModule<Settings>({
+  activate(ctx: ServerContext<Settings>) {
+    /** Config publique (sans clé secrète) — utilisée par les formulaires du site. */
+    ctx.http.get('/config', async () => {
+      const s = ctx.settings();
+      if (!s.enabled || !s.siteKey.trim()) return { enabled: false };
+      return {
+        enabled: true,
+        siteKey: s.siteKey.trim(),
+        version: s.version === 'v3' ? 'v3' : 'v2',
+        action: (s.v3Action || 'contact').slice(0, 40),
+      };
+    });
+
+    ctx.http.post('/verify', async (req) => {
+      const s = ctx.settings();
+      if (!s.enabled) return { ok: true, skipped: true };
+      if (!s.secretKey.trim()) throw ctx.error(503, 'Clé secrète reCAPTCHA manquante.');
+      const token = typeof req.body?.token === 'string' ? req.body.token.trim() : '';
+      if (!token) throw ctx.error(400, 'Jeton reCAPTCHA manquant.');
+
+      const body = new URLSearchParams({
+        secret: s.secretKey.trim(),
+        response: token,
+      });
+      if (typeof req.body?.remoteip === 'string' && req.body.remoteip) {
+        body.set('remoteip', String(req.body.remoteip).slice(0, 64));
+      }
+
+      const res = await fetch('https://www.google.com/recaptcha/api/siteverify', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body,
+      });
+      const data = (await res.json().catch(() => ({}))) as {
+        success?: boolean;
+        score?: number;
+        action?: string;
+        'error-codes'?: string[];
+      };
+
+      if (!data.success) {
+        throw ctx.error(400, 'Vérification reCAPTCHA échouée. Rechargez la page et réessayez.');
+      }
+
+      if (s.version === 'v3') {
+        const min = Number(s.v3MinScore);
+        const score = Number(data.score ?? 0);
+        const threshold = Number.isFinite(min) ? Math.min(1, Math.max(0, min)) : 0.5;
+        if (score < threshold) {
+          throw ctx.error(400, 'Score anti-robot insuffisant. Réessayez ou contactez-nous par téléphone.');
+        }
+      }
+
+      return { ok: true, score: data.score ?? null };
+    });
+  },
+});

package/template/modules/recaptcha/src/types.ts

@@ -0,0 +1,18 @@
+/**
+ * Snapify — module Google reCAPTCHA
+ * © 2026 Hamdi Ayari — hamdi.ayari@novalabs.tn
+ */
+export interface Settings {
+  enabled: boolean;
+  version: 'v2' | 'v3';
+  siteKey: string;
+  secretKey: string;
+  v3Action: string;
+  v3MinScore: number;
+}
+
+export type PublicRecaptcha = {
+  siteKey: string;
+  version: 'v2' | 'v3';
+  action: string;
+};

package/template/modules/shop/snapify.module.json

@@ -0,0 +1,340 @@
+{
+  "id": "novalabs.shop",
+  "name": "Boutique",
+  "version": "1.0.0",
+  "description": "Catalogue de produits : catégories, fiches produit avec galerie, recherche, tri et filtres, gestion du stock, et widgets « Produits » et « Catégories » à placer dans vos pages.",
+  "author": {
+    "name": "NOVALABS WEB DESIGN",
+    "email": "contact@novalabs.tn",
+    "url": "https://novalabs.tn"
+  },
+  "pricing": "free",
+  "category": "E-commerce",
+  "icon": "store",
+  "engines": {
+    "snapify": "^1.2.0"
+  },
+  "permissions": [
+    "http:routes",
+    "admin:routes",
+    "database"
+  ],
+  "slots": [],
+  "routes": [
+    "/boutique/*",
+    "/produit/*"
+  ],
+  "entries": {
+    "public": "src/public/index.tsx",
+    "server": "src/server.ts",
+    "admin": "src/admin/index.tsx"
+  },
+  "adminPages": [
+    {
+      "id": "products",
+      "label": "Produits",
+      "icon": "package"
+    },
+    {
+      "id": "categories",
+      "label": "Catégories",
+      "icon": "folder"
+    }
+  ],
+  "widgets": [
+    {
+      "id": "products",
+      "label": "Produits",
+      "description": "Grille de produits : sélection, nouveautés, promotions ou une catégorie.",
+      "fields": [
+        {
+          "key": "eyebrow",
+          "type": "text",
+          "label": "Surtitre",
+          "default": "Boutique",
+          "maxLength": 60
+        },
+        {
+          "key": "title",
+          "type": "text",
+          "label": "Titre",
+          "default": "Nos produits du moment",
+          "maxLength": 120
+        },
+        {
+          "key": "subtitle",
+          "type": "textarea",
+          "label": "Texte d’introduction",
+          "default": "",
+          "maxLength": 400,
+          "rows": 2
+        },
+        {
+          "key": "source",
+          "type": "select",
+          "label": "Produits affichés",
+          "default": "featured",
+          "options": [
+            {
+              "value": "featured",
+              "label": "Produits mis en avant"
+            },
+            {
+              "value": "latest",
+              "label": "Nouveautés"
+            },
+            {
+              "value": "sale",
+              "label": "En promotion"
+            },
+            {
+              "value": "bestsellers",
+              "label": "Meilleures ventes"
+            },
+            {
+              "value": "category",
+              "label": "Une catégorie"
+            }
+          ]
+        },
+        {
+          "key": "category",
+          "type": "text",
+          "label": "Catégorie (adresse)",
+          "help": "Pour « Une catégorie » : adresse de la catégorie, ex. ceramique.",
+          "default": "",
+          "maxLength": 80
+        },
+        {
+          "key": "limit",
+          "type": "number",
+          "label": "Nombre de produits",
+          "default": 8,
+          "min": 1,
+          "max": 24
+        },
+        {
+          "key": "columns",
+          "type": "select",
+          "label": "Colonnes",
+          "default": "4",
+          "options": [
+            {
+              "value": "3",
+              "label": "3 colonnes"
+            },
+            {
+              "value": "4",
+              "label": "4 colonnes"
+            },
+            {
+              "value": "5",
+              "label": "5 colonnes"
+            }
+          ]
+        },
+        {
+          "key": "buttonLabel",
+          "type": "text",
+          "label": "Bouton « tout voir »",
+          "help": "Vide : pas de bouton.",
+          "default": "Voir toute la boutique",
+          "maxLength": 40
+        }
+      ]
+    },
+    {
+      "id": "categories",
+      "label": "Catégories",
+      "description": "Vignettes des catégories de la boutique.",
+      "fields": [
+        {
+          "key": "eyebrow",
+          "type": "text",
+          "label": "Surtitre",
+          "default": "Collections",
+          "maxLength": 60
+        },
+        {
+          "key": "title",
+          "type": "text",
+          "label": "Titre",
+          "default": "Parcourir par catégorie",
+          "maxLength": 120
+        },
+        {
+          "key": "subtitle",
+          "type": "textarea",
+          "label": "Texte d’introduction",
+          "default": "",
+          "maxLength": 400,
+          "rows": 2
+        },
+        {
+          "key": "limit",
+          "type": "number",
+          "label": "Nombre de catégories",
+          "default": 6,
+          "min": 1,
+          "max": 12
+        },
+        {
+          "key": "style",
+          "type": "select",
+          "label": "Présentation",
+          "default": "tiles",
+          "options": [
+            {
+              "value": "tiles",
+              "label": "Grandes vignettes"
+            },
+            {
+              "value": "chips",
+              "label": "Pastilles compactes"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "settings": [
+    {
+      "key": "shopTitle",
+      "type": "text",
+      "group": "Boutique",
+      "label": "Titre de la boutique",
+      "default": "La boutique",
+      "public": true,
+      "maxLength": 80
+    },
+    {
+      "key": "shopIntro",
+      "type": "textarea",
+      "group": "Boutique",
+      "label": "Introduction",
+      "default": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
+      "public": true,
+      "maxLength": 600,
+      "rows": 3
+    },
+    {
+      "key": "perPage",
+      "type": "number",
+      "group": "Boutique",
+      "label": "Produits par page",
+      "default": 12,
+      "min": 4,
+      "max": 48,
+      "public": true
+    },
+    {
+      "key": "defaultSort",
+      "type": "select",
+      "group": "Boutique",
+      "label": "Tri par défaut",
+      "default": "featured",
+      "public": true,
+      "options": [
+        {
+          "value": "featured",
+          "label": "Mis en avant d’abord"
+        },
+        {
+          "value": "latest",
+          "label": "Nouveautés"
+        },
+        {
+          "value": "price-asc",
+          "label": "Prix croissant"
+        },
+        {
+          "value": "price-desc",
+          "label": "Prix décroissant"
+        },
+        {
+          "value": "name",
+          "label": "Nom (A → Z)"
+        }
+      ]
+    },
+    {
+      "key": "currency",
+      "type": "select",
+      "group": "Prix et stock",
+      "label": "Devise",
+      "default": "TND",
+      "public": true,
+      "options": [
+        {
+          "value": "TND",
+          "label": "Dinar tunisien (DT)"
+        },
+        {
+          "value": "EUR",
+          "label": "Euro (€)"
+        },
+        {
+          "value": "USD",
+          "label": "Dollar américain ($)"
+        },
+        {
+          "value": "MAD",
+          "label": "Dirham marocain (MAD)"
+        },
+        {
+          "value": "DZD",
+          "label": "Dinar algérien (DA)"
+        }
+      ]
+    },
+    {
+      "key": "showStock",
+      "type": "boolean",
+      "group": "Prix et stock",
+      "label": "Afficher le stock restant sur la fiche produit",
+      "default": true,
+      "public": true
+    },
+    {
+      "key": "lowStockThreshold",
+      "type": "number",
+      "group": "Prix et stock",
+      "label": "Seuil de stock faible",
+      "help": "En dessous, la fiche indique « Plus que N en stock » et l’administration signale le produit.",
+      "default": 5,
+      "min": 0,
+      "max": 1000,
+      "public": true
+    },
+    {
+      "key": "hideOutOfStock",
+      "type": "boolean",
+      "group": "Prix et stock",
+      "label": "Masquer les produits épuisés du catalogue",
+      "default": false
+    },
+    {
+      "key": "deliveryText",
+      "type": "textarea",
+      "group": "Fiche produit",
+      "label": "Livraison et retours",
+      "help": "Texte de l’onglet « Livraison et retours » de chaque fiche produit.",
+      "default": "Livraison en 48 à 72 h partout en Tunisie. Lorem ipsum dolor sit amet, consectetur adipiscing elit.\nRetours acceptés sous 14 jours dans leur emballage d’origine. Ut enim ad minim veniam, quis nostrud exercitation.",
+      "public": true,
+      "maxLength": 3000,
+      "rows": 5
+    },
+    {
+      "key": "reassurance",
+      "type": "textarea",
+      "group": "Fiche produit",
+      "label": "Arguments de réassurance",
+      "help": "Un argument par ligne (4 au maximum), affichés sous le bouton d’achat.",
+      "default": "Livraison rapide partout en Tunisie\nPaiement à la livraison\nRetours sous 14 jours\nService client à votre écoute",
+      "public": true,
+      "maxLength": 600,
+      "rows": 4
+    }
+  ],
+  "screenshot": "screenshot.jpg"
+}