@press2ai/engine 0.4.0 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@press2ai/engine",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Multi-tenant runtime + template contracts dla otwarty-* verticali. SSR na Cloudflare Workers, isomorphic renderer (SSG/browser w roadmapie).",
   "type": "module",
   "license": "MIT",

package/src/ceidg-vertical.ts

@@ -22,10 +22,10 @@
  *     i — fix względem starego trener-landinga — `cities` query też filtruje
  *     po kategorii (wcześniej trener pokazywał miasta z całej tabeli leads,
  *     mieszając wszystkie wertykale).
- *   - Opt-out jest **globalny** i **hard delete**: DELETE FROM leads + wpis
- *     w `opted_out_nips` (blacklist NIP-ów żeby sync nie wprowadził z powrotem).
- *     RODO art. 17 — usunięcie danych osobowych, nie soft flag. Z karty profilu
- *     przez slug (jeden klik), bez formularza NIP.
+ *   - Opt-out jest **globalny** — UPDATE leads bez filtra category. RODO
+ *     sprzeciw to usunięcie danych osobowych, nie selektywne ukrycie w jednej
+ *     kategorii. Soft flag + filtr w queries — hard delete bez proof-of-ownership
+ *     jest podatny na sabotage (patrz NEXT-STEPS manifest-1/manifest-2 notatka).
  *
  * Hono jest peer dependency (każdy wertykal i tak go ma). Engine core nie
  * importuje Hono — tylko ten subpath go używa.
@@ -54,6 +54,7 @@ export type CeidgLead = {
   claimed: number;
   external_site_url: string | null;
   fetched_at: number;
+  opted_out_at: number | null;
 };
 
 export type CeidgBindings = { DB: D1Database; CACHE: KVNamespace };
@@ -76,6 +77,10 @@ export interface VerticalConfig {
     heroTitle: string;
     heroSubtitle?: string;
     searchPlaceholder?: string;
+    /** Plural label for count in statBar (e.g. 'trenerów', 'terapeutów'). Default 'wpisów'. */
+    itemsLabel?: string;
+    /** Singular fallback for 404 (e.g. 'trenera', 'terapeuty'). Default 'wpisu'. */
+    itemSingular?: string;
   };
   /** PKD → human-readable jobTitle. Per-wertykal mapping. */
   pkdToJobTitle(pkd: string | null | undefined): string;
@@ -108,15 +113,17 @@ export function createVerticalApp(config: VerticalConfig): Hono<{ Bindings: Ceid
   // ─────────── SQL ───────────
   // EXISTS subselect zamiast JOIN: lead z N PKDs nie multiplikuje wierszy.
   // (SELECT pkd ... LIMIT 1) wybiera jeden PKD per lead — wystarczy do
-  // pkdToJobTitle. Świadome uproszczenie: lead z mieszanymi PKDs dostanie
-  // jeden label. Filtr opted-out zbędny — opt-out to hard delete (0010).
+  // pkdToJobTitle. To jest świadomy uproszczenie: lead z mieszanymi PKDs
+  // (np. fizjoterapia + psychologia) dostanie tylko jeden label.
   const leadsQuery = `
     SELECT l.nip, l.first_name, l.last_name, c.name as city,
            l.company_name, l.slug, l.claimed, l.external_site_url, l.fetched_at,
+           l.opted_out_at,
            (SELECT pkd FROM lead_pkd WHERE nip = l.nip LIMIT 1) as pkd
     FROM leads l
     LEFT JOIN cities c ON l.city_id = c.id
-    WHERE EXISTS (SELECT 1 FROM lead_categories WHERE lead_nip = l.nip AND category = ?)`;
+    WHERE l.opted_out_at IS NULL
+      AND EXISTS (SELECT 1 FROM lead_categories WHERE lead_nip = l.nip AND category = ?)`;
 
   // Cities query filtruje po kategorii — fix względem starego trener landinga
   // który pokazywał miasta z całej tabeli leads (mieszane wertykale).
@@ -125,6 +132,7 @@ export function createVerticalApp(config: VerticalConfig): Hono<{ Bindings: Ceid
     FROM leads l
     JOIN cities c ON l.city_id = c.id
     INNER JOIN lead_categories lc ON l.nip = lc.lead_nip AND lc.category = ?
+    WHERE l.opted_out_at IS NULL
     GROUP BY c.name ORDER BY count DESC LIMIT 8`;
 
   // ─────────── Content loader ───────────
@@ -155,6 +163,8 @@ export function createVerticalApp(config: VerticalConfig): Hono<{ Bindings: Ceid
         heroTitle: copy.heroTitle,
         heroSubtitle: copy.heroSubtitle,
         searchPlaceholder: copy.searchPlaceholder ?? 'Szukaj...',
+        itemsLabel: copy.itemsLabel ?? 'wpisów',
+        itemSingular: copy.itemSingular ?? 'wpisu',
       },
       profiles: (leadsRes.results ?? []).map(leadToProfile),
       cities: citiesRes.results ?? [],
@@ -258,15 +268,10 @@ export function createVerticalApp(config: VerticalConfig): Hono<{ Bindings: Ceid
   }
   app.get('/opt-out', (c) => c.html(renderStatic(pages.optOutForm)));
 
-  // One-click opt-out: przycisk na karcie profilu POST-uje slug. Hard delete
-  // z `leads` (cascade do `lead_pkd`/`lead_categories`) + insert do blacklisty
-  // `opted_out_nips` żeby sync nie wprowadził NIP-a z powrotem. Rate limit
-  // 5/h/IP przeciw abuse — slug jest publiczny, ktokolwiek może nukeować,
-  // ale katalog to publiczne wizytówki z CEIDG, nie konta.
   app.post('/opt-out', async (c) => {
     const form = await c.req.formData();
-    const slug = String(form.get('slug') ?? '').trim();
-    if (!slug) return c.text('Brak slug', 400);
+    const nip = String(form.get('nip') ?? '').replace(/\D/g, '');
+    if (nip.length !== 10) return c.text('Nieprawidłowy NIP', 400);
 
     const ip = c.req.header('cf-connecting-ip') ?? '0.0.0.0';
     const rlKey = `vertical:${category}:rl:optout:${ip}`;
@@ -274,21 +279,20 @@ export function createVerticalApp(config: VerticalConfig): Hono<{ Bindings: Ceid
     if (rlVal >= OPTOUT_LIMIT) return c.text('Zbyt wiele prób. Spróbuj ponownie za godzinę.', 429);
     await c.env.CACHE.put(rlKey, String(rlVal + 1), { expirationTtl: OPTOUT_WINDOW_SEC });
 
-    const row = await c.env.DB
-      .prepare('SELECT nip FROM leads WHERE slug = ?')
-      .bind(slug)
-      .first<{ nip: string }>();
-    if (!row) return c.text('Nie znaleziono wpisu', 404);
-
-    const now = Math.floor(Date.now() / 1000);
-    const ipHash = await sha256Hex(ip + ':' + slug);
-    await c.env.DB.batch([
-      c.env.DB.prepare('INSERT OR IGNORE INTO opted_out_nips (nip, opted_out_at, ip_hash) VALUES (?, ?, ?)').bind(row.nip, now, ipHash),
-      c.env.DB.prepare('DELETE FROM lead_categories WHERE lead_nip = ?').bind(row.nip),
-      c.env.DB.prepare('DELETE FROM lead_pkd WHERE nip = ?').bind(row.nip),
-      c.env.DB.prepare('DELETE FROM leads WHERE nip = ?').bind(row.nip),
-    ]);
-
+    // Opt-out jest GLOBALNY — usuwa też z innych wertykali. RODO sprzeciw to
+    // usunięcie danych osobowych, nie selektywne ukrycie w jednej kategorii.
+    // Soft flag (nie DELETE) — defense in depth przeciw masowej sabotage:
+    // catalog.json emituje slug+imię+miasto bez NIP, więc adversary musi
+    // zmapować slug→NIP przez CEIDG pod rate limit (6000 req/h); dodatkowo
+    // soft flag jest natychmiast odwracalny jednym UPDATE gdyby coś poszło nie tak.
+    const res = await c.env.DB
+      .prepare(
+        'UPDATE leads SET opted_out_at = ?, opted_out_ip = ?, opted_out_ua = ? WHERE nip = ? AND opted_out_at IS NULL',
+      )
+      .bind(Math.floor(Date.now() / 1000), ip, c.req.header('user-agent') ?? '', nip)
+      .run();
+
+    if (!res.meta.changes) return c.text('Nie znaleziono wpisu', 404);
     return c.html(renderStatic(pages.optOutDone));
   });
 
@@ -310,8 +314,3 @@ export function createVerticalApp(config: VerticalConfig): Hono<{ Bindings: Ceid
 
   return app;
 }
-
-async function sha256Hex(input: string): Promise<string> {
-  const buf = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(input));
-  return Array.from(new Uint8Array(buf)).map((b) => b.toString(16).padStart(2, '0')).join('');
-}

package/src/template-trener.ts

@@ -67,6 +67,10 @@ const trenerContentSchema = z.object({
     heroTitle: z.string(),
     heroSubtitle: z.string().optional(),
     searchPlaceholder: z.string().default('Szukaj...'),
+    /** Plural label for the count in statBar (e.g. 'trenerów', 'terapeutów'). */
+    itemsLabel: z.string().default('wpisów'),
+    /** Singular fallback shown on 404 (e.g. 'trenera', 'terapeuty'). */
+    itemSingular: z.string().default('wpisu'),
   }),
   profiles: z.array(profileSchema),
   cities: z.array(z.object({ name: z.string(), count: z.number() })).default([]),
@@ -96,6 +100,8 @@ export const trenerTemplate: PresenceTemplate<TrenerContent, TrenerTheme> = {
       heroTitle: 'Znajdź trenera w Twojej okolicy',
       heroSubtitle: 'Otwarty katalog trenerów. Bezpłatnie i bez rejestracji.',
       searchPlaceholder: 'Szukaj po nazwisku, mieście lub firmie...',
+      itemsLabel: 'wpisów',
+      itemSingular: 'wpisu',
     },
     profiles: [],
     cities: [],
@@ -196,7 +202,7 @@ function renderIndex(req: RenderRequest<TrenerContent>, ctx: RenderContext<Trene
   });
 
   const stats = t.statBar([
-    { value: total.toLocaleString('pl'), label: 'trenerów', icon: 'people' },
+    { value: total.toLocaleString('pl'), label: content.copy.itemsLabel, icon: 'people' },
     { value: String(content.cities.length), label: 'miast', icon: 'city' },
     { value: '100%', label: 'bezpłatnie', icon: 'free' },
   ]);
@@ -241,7 +247,7 @@ function renderProfile(req: RenderRequest<TrenerContent>, ctx: RenderContext<Tre
   if (!profile) {
     return {
       status: 404,
-      body: ctx.theme.layout({ title: 'Nie znaleziono' }, '<h1>404</h1><p>Brak takiego trenera.</p>'),
+      body: ctx.theme.layout({ title: 'Nie znaleziono' }, `<h1>404</h1><p>Brak takiego ${req.content.copy.itemSingular}.</p>`),
     };
   }