create-snapify-app 0.0.0-stage → 1.1.0

package/template/community/hamdiayari/akhbar-actualites/src/public/widgets.tsx

@@ -0,0 +1,226 @@
+/**
+ * Akhbar Actualités — widgets du bloc « Module »
+ * © 2026 Hamdi Ayari
+ */
+import { useEffect, useMemo, useState } from 'react';
+import { ArrowRight } from 'lucide-react';
+import type { WidgetProps } from '@snapify/sdk';
+import type { Ranked, Settings } from '../types';
+import { Empty, Go, PostCard, SectionTitle, Skeleton, type CardContext } from './cards';
+import { allRubriques, byRubrique, rubriqueHref, usePosts, type PostMeta } from './posts';
+
+type Props<O> = WidgetProps<Settings, O>;
+
+const clamp = (v: unknown, min: number, max: number, fallback: number) => {
+  const n = Math.round(Number(v));
+  return Number.isFinite(n) ? Math.min(max, Math.max(min, n)) : fallback;
+};
+
+function cardContext(p: Props<unknown>): CardContext {
+  return { navigate: p.navigate, showAuthor: p.settings.showAuthor !== false, relativeDates: p.settings.relativeDates !== false };
+}
+
+function NoPosts({ isPreview, rubrique }: { isPreview: boolean; rubrique?: string }) {
+  if (!isPreview) return null;
+  return <Empty>{rubrique ? `Aucun article publié avec l’étiquette « ${rubrique} ».` : 'Aucun article publié pour le moment.'}</Empty>;
+}
+
+function MoreLink({ to, label, ctx }: { to: string; label: string; ctx: CardContext }) {
+  if (!label.trim()) return null;
+  return (
+    <Go to={to} ctx={ctx} className="akn-more">
+      {label} <ArrowRight className="h-4 w-4" aria-hidden />
+    </Go>
+  );
+}
+
+/* ---------------------------------- À la une ---------------------------------- */
+
+export function UneWidget(props: Props<{ rubrique?: string; layout?: 'mosaic' | 'split' | 'cover'; showExcerpt?: boolean }>) {
+  const { options, isPreview } = props;
+  const posts = usePosts();
+  const ctx = cardContext(props);
+  const list = useMemo(() => (posts ? byRubrique(posts, options.rubrique || '') : []), [posts, options.rubrique]);
+  if (!posts) return <Skeleton rows={4} />;
+  if (!list.length) return <NoPosts isPreview={isPreview} rubrique={options.rubrique} />;
+  const [main, ...rest] = list;
+  const excerpt = options.showExcerpt !== false;
+
+  if (options.layout === 'cover') {
+    return (
+      <section className="akn-widget akn-une-cover">
+        <PostCard post={main} ctx={ctx} variant="cover" excerpt={excerpt} />
+        {rest.length ? (
+          <div className="akn-une-strip">
+            {rest.slice(0, 3).map((p) => (
+              <PostCard key={p.id} post={p} ctx={ctx} variant="headline" />
+            ))}
+          </div>
+        ) : null}
+      </section>
+    );
+  }
+
+  if (options.layout === 'split') {
+    return (
+      <section className="akn-widget akn-une-split">
+        <PostCard post={main} ctx={ctx} variant="lead" excerpt={excerpt} />
+        <div className="akn-une-list">
+          {rest.slice(0, 5).map((p) => (
+            <PostCard key={p.id} post={p} ctx={ctx} variant="row" excerpt={false} />
+          ))}
+        </div>
+      </section>
+    );
+  }
+
+  return (
+    <section className="akn-widget akn-une-mosaic">
+      <div className="akn-une-main">
+        <PostCard post={main} ctx={ctx} variant="lead" excerpt={excerpt} />
+      </div>
+      {rest.slice(0, 4).map((p) => (
+        <PostCard key={p.id} post={p} ctx={ctx} variant="card" excerpt={false} />
+      ))}
+    </section>
+  );
+}
+
+/* ----------------------------- Dernières actualités ----------------------------- */
+
+export function LatestWidget(
+  props: Props<{ title?: string; rubrique?: string; limit?: number; skip?: number; layout?: 'grid' | 'list' | 'compact'; buttonLabel?: string }>
+) {
+  const { options, isPreview } = props;
+  const posts = usePosts();
+  const ctx = cardContext(props);
+  if (!posts) return <Skeleton rows={4} />;
+  const filtered = byRubrique(posts, options.rubrique || '');
+  const list = filtered.slice(clamp(options.skip, 0, 20, 0), clamp(options.skip, 0, 20, 0) + clamp(options.limit, 1, 24, 6));
+  const more = options.rubrique ? rubriqueHref(options.rubrique) : '/actualites/';
+  const layout = options.layout || 'grid';
+
+  return (
+    <section className="akn-widget">
+      {options.title ? <SectionTitle action={<MoreLink to={more} label={options.buttonLabel || ''} ctx={ctx} />}>{options.title}</SectionTitle> : null}
+      {!list.length ? (
+        <NoPosts isPreview={isPreview} rubrique={options.rubrique} />
+      ) : layout === 'compact' ? (
+        <div className="akn-compact">
+          {list.map((p) => (
+            <PostCard key={p.id} post={p} ctx={ctx} variant="headline" />
+          ))}
+        </div>
+      ) : layout === 'list' ? (
+        <div className="akn-list">
+          {list.map((p) => (
+            <PostCard key={p.id} post={p} ctx={ctx} variant="row" />
+          ))}
+        </div>
+      ) : (
+        <div className="akn-grid">
+          {list.map((p) => (
+            <PostCard key={p.id} post={p} ctx={ctx} variant="card" />
+          ))}
+        </div>
+      )}
+      {!options.title && list.length ? (
+        <div className="akn-more-row">
+          <MoreLink to={more} label={options.buttonLabel || ''} ctx={ctx} />
+        </div>
+      ) : null}
+    </section>
+  );
+}
+
+/* ---------------------------------- Rubrique ---------------------------------- */
+
+export function RubriqueWidget(props: Props<{ rubrique?: string; title?: string; limit?: number }>) {
+  const { options, isPreview } = props;
+  const posts = usePosts();
+  const ctx = cardContext(props);
+  if (!posts) return <Skeleton rows={4} />;
+  const tag = (options.rubrique || '').trim();
+  const list = byRubrique(posts, tag).slice(0, clamp(options.limit, 2, 12, 4));
+  if (!tag || !list.length) return <NoPosts isPreview={isPreview} rubrique={tag || '—'} />;
+  const [main, ...rest] = list;
+  return (
+    <section className="akn-widget">
+      <SectionTitle action={<MoreLink to={rubriqueHref(tag)} label="Toute la rubrique" ctx={ctx} />}>{options.title || tag}</SectionTitle>
+      <div className="akn-rubrique">
+        <PostCard post={main} ctx={ctx} variant="lead" />
+        <div className="akn-list">
+          {rest.map((p) => (
+            <PostCard key={p.id} post={p} ctx={ctx} variant="row" excerpt={false} />
+          ))}
+        </div>
+      </div>
+    </section>
+  );
+}
+
+/* --------------------------------- Les plus lus --------------------------------- */
+
+export function MostReadWidget(props: Props<{ title?: string; limit?: number; days?: string }>) {
+  const { options, isPreview, api } = props;
+  const posts = usePosts();
+  const ctx = cardContext(props);
+  const limit = clamp(options.limit, 3, 10, 5);
+  const days = options.days || '7';
+  const [ranked, setRanked] = useState<Ranked[] | null>(null);
+
+  useEffect(() => {
+    let alive = true;
+    api
+      .get<{ items: Ranked[] }>(`/most-read?days=${encodeURIComponent(days)}&limit=${limit * 2}`)
+      .then((r) => alive && setRanked(r.items))
+      .catch(() => alive && setRanked([]));
+    return () => {
+      alive = false;
+    };
+  }, [api, days, limit]);
+
+  if (!posts || !ranked) return <Skeleton rows={limit} />;
+  const bySlug = new Map(posts.map((p) => [p.slug, p] as const));
+  let list = ranked.map((r) => bySlug.get(r.slug)).filter((p): p is PostMeta => !!p);
+  // Peu de lectures enregistrées : on complète avec les articles récents.
+  if (list.length < limit) list = [...list, ...posts.filter((p) => !list.includes(p))];
+  list = list.slice(0, limit);
+  if (!list.length) return <NoPosts isPreview={isPreview} />;
+
+  return (
+    <section className="akn-widget akn-mostread">
+      {options.title ? <SectionTitle>{options.title}</SectionTitle> : null}
+      <ol className="akn-compact">
+        {list.map((p, i) => (
+          <li key={p.id}>
+            <PostCard post={p} ctx={ctx} variant="headline" rank={i + 1} />
+          </li>
+        ))}
+      </ol>
+    </section>
+  );
+}
+
+/* ---------------------------------- Rubriques ---------------------------------- */
+
+export function TagsWidget(props: Props<{ title?: string }>) {
+  const { options, isPreview } = props;
+  const posts = usePosts();
+  const ctx = cardContext(props);
+  if (!posts) return <Skeleton rows={2} />;
+  const tags = allRubriques(posts);
+  if (!tags.length) return <NoPosts isPreview={isPreview} />;
+  return (
+    <section className="akn-widget">
+      {options.title ? <SectionTitle>{options.title}</SectionTitle> : null}
+      <div className="akn-chips">
+        {tags.map((t) => (
+          <Go key={t.tag} to={rubriqueHref(t.tag)} ctx={ctx} className="akn-chip">
+            {t.tag} <span className="akn-chip-count">{t.count}</span>
+          </Go>
+        ))}
+      </div>
+    </section>
+  );
+}

package/template/community/hamdiayari/akhbar-actualites/src/server.ts

@@ -0,0 +1,119 @@
+/**
+ * Akhbar Actualités — mesure d’audience des articles
+ * © 2026 Hamdi Ayari
+ */
+import { defineServerModule, type ServerContext } from '@snapify/sdk';
+import type { DailyViews, Ranked, Settings } from './types';
+
+const SLUG = /^[a-z0-9][a-z0-9-]{0,119}$/;
+const DEDUPE_MS = 30 * 60_000;
+const KEEP_DAYS = 90;
+const MAX_ROWS = 5_000;
+
+const dayOf = (t: number) => new Date(t).toISOString().slice(0, 10);
+const clampInt = (v: unknown, min: number, max: number, fallback: number) => {
+  const n = Math.round(Number(v));
+  return Number.isFinite(n) ? Math.min(max, Math.max(min, n)) : fallback;
+};
+
+export default defineServerModule<Settings>({
+  activate(ctx: ServerContext<Settings>) {
+    const views = ctx.db.collection<DailyViews>('views');
+    /** Lectures récentes (IP + article) : jamais persistées, oubliées après 30 minutes. */
+    const recent = new Map<string, number>();
+
+    async function rowsSince(days: number) {
+      const rows: DailyViews[] = [];
+      const filters = [{ field: 'day', op: 'gte' as const, value: dayOf(Date.now() - (days - 1) * 86_400_000) }];
+      for (let offset = 0; offset < MAX_ROWS; offset += 500) {
+        const { items } = await views.find({ filters, orderBy: [{ field: 'day', dir: 'desc' }], limit: 500, offset });
+        rows.push(...items);
+        if (items.length < 500) break;
+      }
+      return rows;
+    }
+
+    function rank(rows: DailyViews[], limit: number): Ranked[] {
+      const totals = new Map<string, number>();
+      for (const r of rows) totals.set(r.slug, (totals.get(r.slug) ?? 0) + (r.count || 0));
+      return [...totals.entries()]
+        .map(([slug, n]) => ({ slug, views: n }))
+        .sort((a, b) => b.views - a.views || a.slug.localeCompare(b.slug))
+        .slice(0, limit);
+    }
+
+    async function prune() {
+      const now = Date.now();
+      for (const [k, t] of recent) if (now - t > DEDUPE_MS) recent.delete(k);
+      const { items } = await views.find({ filters: [{ field: 'day', op: 'lt', value: dayOf(now - KEEP_DAYS * 86_400_000) }], limit: 500 });
+      for (const r of items) await views.delete(r.id);
+    }
+    const timer = setInterval(() => void prune().catch((e) => ctx.log.warn('purge audience', e)), 60 * 60_000);
+    void prune().catch(() => undefined);
+
+    ctx.http.post('/views', async (req) => {
+      if (!ctx.settings().trackViews) return { counted: false };
+      const raw = (req.body as { slug?: unknown } | null)?.slug;
+      const slug = typeof raw === 'string' ? raw : '';
+      if (!SLUG.test(slug)) throw ctx.error(422, 'Article invalide');
+      if (/bot|crawl|spider|slurp|preview|headless/i.test(req.userAgent || '')) return { counted: false };
+
+      const now = Date.now();
+      const key = `${req.ip}|${slug}`;
+      if (now - (recent.get(key) ?? 0) < DEDUPE_MS) return { counted: false };
+      recent.set(key, now);
+      if (recent.size > 50_000) recent.clear();
+
+      const day = dayOf(now);
+      await ctx.lock(`views:${day}:${slug}`, async () => {
+        const row = await views.findOne({ slug, day });
+        if (row) await views.update(row.id, { count: (row.count || 0) + 1 });
+        else await views.insert({ slug, day, count: 1 });
+      });
+      return { counted: true };
+    });
+
+    ctx.http.get('/most-read', async (req) => {
+      const days = [1, 7, 30].includes(Number(req.query.days)) ? Number(req.query.days) : 7;
+      return { days, items: rank(await rowsSince(days), clampInt(req.query.limit, 1, 20, 5)) };
+    });
+
+    ctx.admin.get('/stats', async (req) => {
+      const days = [7, 30, 90].includes(Number(req.query.days)) ? Number(req.query.days) : 30;
+      const rows = await rowsSince(days);
+      const perDay = new Map<string, number>();
+      for (const r of rows) perDay.set(r.day, (perDay.get(r.day) ?? 0) + (r.count || 0));
+      const timeline = Array.from({ length: days }, (_, i) => {
+        const day = dayOf(Date.now() - (days - 1 - i) * 86_400_000);
+        return { day, views: perDay.get(day) ?? 0 };
+      });
+      const top = rank(rows, 50);
+      return { days, total: timeline.reduce((s, d) => s + d.views, 0), articles: new Set(rows.map((r) => r.slug)).size, timeline, top };
+    });
+
+    ctx.admin.post('/reset', async () => {
+      let removed = 0;
+      for (;;) {
+        const { items } = await views.find({ limit: 500 });
+        if (!items.length) break;
+        for (const r of items) if (await views.delete(r.id)) removed++;
+      }
+      recent.clear();
+      return { removed };
+    });
+
+    ctx.admin.status(async () => {
+      const today = rank(await rowsSince(1), 1000);
+      const week = await rowsSince(7);
+      return {
+        stats: [
+          { label: 'Lectures aujourd’hui', value: today.reduce((s, r) => s + r.views, 0) },
+          { label: 'Lectures sur 7 jours', value: week.reduce((s, r) => s + (r.count || 0), 0) },
+        ],
+        alerts: ctx.settings().trackViews ? [] : [{ tone: 'warning', text: 'La mesure d’audience est désactivée : le widget « Les plus lus » reste vide.' }],
+      };
+    });
+
+    return () => clearInterval(timer);
+  },
+});

package/template/community/hamdiayari/akhbar-actualites/src/types.ts

@@ -0,0 +1,25 @@
+/**
+ * Akhbar Actualités
+ * © 2026 Hamdi Ayari
+ */
+export interface Settings {
+  archiveTitle: string;
+  archiveIntro: string;
+  perPage: number;
+  showAuthor: boolean;
+  relativeDates: boolean;
+  headerSearch: boolean;
+  trackViews: boolean;
+}
+
+/** Lectures d’un article pour une journée (identifiant `AAAA-MM-JJ:slug`). */
+export interface DailyViews {
+  slug: string;
+  day: string;
+  count: number;
+}
+
+export interface Ranked {
+  slug: string;
+  views: number;
+}

package/template/community/hamdiayari/akhbar-urgent/README.md

@@ -0,0 +1,36 @@
+# Akhbar Urgent
+
+Flashs info et alertes pour les sites d’actualité.
+
+## Utilisation
+
+1. Activez le module, puis ouvrez **Flashs info** dans le menu de l’administration.
+2. Cliquez sur **Nouveau flash** : texte (220 caractères), lien facultatif vers un article, type (Urgent, En direct, Info) et période de diffusion.
+3. Le flash défile aussitôt dans le bandeau. Il disparaît seul à la fin de sa diffusion, ou avec le bouton **Retirer maintenant**.
+
+Un flash épinglé reste en tête du bandeau.
+
+## Affichage
+
+- **Thème Akhbar** : le bandeau s’affiche automatiquement sous l’en-tête.
+- **Autres thèmes** : ajoutez le widget **Fil urgent** dans une page (bloc Module), ou activez **Barre d’alerte en bas de l’écran** dans les réglages.
+
+Le bandeau se met à jour toutes les minutes et s’arrête au survol.
+
+## Réglages
+
+| Réglage | Rôle |
+| --- | --- |
+| Étiquette du bandeau | Texte de la pastille (« Urgent » par défaut) |
+| Vitesse de défilement | Lente, normale ou rapide |
+| Flashs affichés au maximum | 1 à 20 |
+| Barre d’alerte en bas de l’écran | Pour les thèmes qui n’intègrent pas le bandeau |
+| Durée par défaut d’un flash | Expiration proposée à la création |
+
+## Permissions
+
+- `http:routes` : liste publique des flashs en ligne.
+- `admin:routes` : gestion des flashs dans l’administration.
+- `database` : stockage des flashs.
+
+Contact : hamdi.ayari@novalabs.tn

package/template/community/hamdiayari/akhbar-urgent/snapify.module.json

@@ -0,0 +1,64 @@
+{
+  "id": "hamdiayari.akhbar-urgent",
+  "name": "Akhbar Urgent",
+  "version": "1.0.0",
+  "description": "Flashs info et alertes « Urgent » pour les sites d’actualité : saisie et programmation dans l’administration, bandeau défilant dans l’en-tête du thème Akhbar, widget « Fil urgent » et barre d’alerte compatible avec tous les thèmes.",
+  "author": { "name": "Hamdi Ayari", "email": "hamdi.ayari@novalabs.tn" },
+  "pricing": "free",
+  "category": "Presse",
+  "icon": "zap",
+  "screenshot": "screenshot.jpg",
+  "engines": { "snapify": "^1.2.0" },
+  "permissions": ["http:routes", "admin:routes", "database"],
+  "slots": ["floating"],
+  "entries": { "public": "src/public/index.tsx", "server": "src/server.ts", "admin": "src/admin/index.tsx" },
+  "adminPages": [{ "id": "flashes", "label": "Flashs info", "icon": "zap" }],
+  "widgets": [
+    {
+      "id": "ticker",
+      "label": "Fil urgent",
+      "description": "Bandeau défilant des flashs info en cours.",
+      "fields": [
+        { "key": "label", "type": "text", "label": "Étiquette", "default": "", "help": "Vide : étiquette définie dans les réglages du module.", "maxLength": 24 },
+        {
+          "key": "tone",
+          "type": "select",
+          "label": "Couleur",
+          "default": "red",
+          "options": [
+            { "value": "red", "label": "Rouge alerte" },
+            { "value": "dark", "label": "Sombre" },
+            { "value": "light", "label": "Clair" }
+          ]
+        }
+      ]
+    }
+  ],
+  "settings": [
+    { "key": "label", "type": "text", "group": "Affichage", "label": "Étiquette du bandeau", "default": "Urgent", "public": true, "maxLength": 24 },
+    {
+      "key": "speed",
+      "type": "select",
+      "group": "Affichage",
+      "label": "Vitesse de défilement",
+      "default": "normal",
+      "public": true,
+      "options": [
+        { "value": "slow", "label": "Lente" },
+        { "value": "normal", "label": "Normale" },
+        { "value": "fast", "label": "Rapide" }
+      ]
+    },
+    { "key": "maxItems", "type": "number", "group": "Affichage", "label": "Flashs affichés au maximum", "default": 8, "min": 1, "max": 20, "public": true },
+    {
+      "key": "floatingBar",
+      "type": "boolean",
+      "group": "Affichage",
+      "label": "Barre d’alerte en bas de l’écran",
+      "help": "Pour les thèmes qui n’intègrent pas le bandeau (Akhbar l’affiche déjà sous son en-tête).",
+      "default": false,
+      "public": true
+    },
+    { "key": "defaultHours", "type": "number", "group": "Saisie", "label": "Durée par défaut d’un flash (heures)", "help": "Expiration proposée à la création ; 0 = sans expiration.", "default": 12, "min": 0, "max": 720 }
+  ]
+}