@press2ai/engine 0.6.0 → 1.0.0

package/src/template-catalog.ts

@@ -1,276 +0,0 @@
-/**
- * template-catalog — referencyjna implementacja PresenceTemplate.
- *
- * Uniwersalny katalog wizytówek (trener, terapeuta, lekarz, ...).
- * Engine wywoła render() per request (SSR) albo per route (SSG);
- * template nie wie który tryb jest aktywny i nie powinien tego sprawdzać.
- */
-
-import { z } from 'zod';
-import type {
-  PresenceTemplate,
-  RenderRequest,
-  RenderContext,
-  RenderResult,
-  SitemapEntry,
-} from './types';
-
-/* ─────────────── Theme contract dla tego templatu ───────────────
- * Każdy template deklaruje JAKIEGO theme'u potrzebuje. Engine pilnuje
- * przez generics że theme przekazany do createWorker() ma te same metody.
- */
-export interface CatalogTheme {
-  layout(props: { title: string; description?: string; jsonLd?: object; headExtra?: string }, body: string): string;
-  catalogHero(p: { badge?: string; title: string; subtitle?: string; searchAction?: string; searchPlaceholder?: string; searchValue?: string }): string;
-  catalogGrid(p: { title: string; filters?: string; cards: string }): string;
-  statBar(items: { value: string; label: string; icon?: string }[], summary?: string): string;
-  categoryNav(items: { href: string; label: string }[], ariaLabel?: string): string;
-  pagination(p: { current: number; total: number; extraParams?: string }): string;
-  profileCard(p: CatalogProfile, href: string): string;
-  profileArticle(p: CatalogProfile): string;
-  esc(s: string): string;
-}
-
-/* ─────────────── Schema treści ─────────────── */
-
-const profileSchema = z.object({
-  slug: z.string(),
-  firstName: z.string(),
-  lastName: z.string(),
-  jobTitle: z.string().default('Specjalista'),
-  city: z.string().optional(),
-  bio: z.string().optional(),
-  photo: z.string().url().optional(),
-  specialties: z.array(z.string()).default([]),
-  languages: z.array(z.string()).default([]),
-  business: z
-    .object({
-      name: z.string().optional(),
-      taxId: z.string().optional(),
-      classification: z.array(z.string()).default([]),
-    })
-    .default({}),
-  social: z.record(z.string(), z.string()).default({}),
-});
-
-export type CatalogProfile = z.infer<typeof profileSchema>;
-
-const catalogContentSchema = z.object({
-  brand: z.object({
-    siteName: z.string(),
-    description: z.string(),
-  }),
-  copy: z.object({
-    heroBadge: z.string().optional(),
-    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(),
-    /** Singular fallback shown on 404 (e.g. 'trenera', 'terapeuty'). */
-    itemSingular: z.string(),
-  }),
-  profiles: z.array(profileSchema),
-  cities: z.array(z.object({ name: z.string(), count: z.number() })).default([]),
-  sections: z.object({
-    afterHero: z.string().default(''),
-    afterGrid: z.string().default(''),
-  }).default({}),
-});
-
-export type CatalogContent = z.infer<typeof catalogContentSchema>;
-
-const PAGE_SIZE = 12;
-
-/* ─────────────── Template ─────────────── */
-
-export const catalogTemplate: PresenceTemplate<CatalogContent, CatalogTheme> = {
-  kind: 'presence',
-  id: 'catalog',
-  name: 'Otwarty Katalog',
-  version: '1.0.0',
-
-  schema: catalogContentSchema,
-
-  defaultContent: {
-    brand: {
-      siteName: 'Otwarty Katalog',
-      description: 'Otwarta baza specjalistów w Polsce. Dane z CEIDG.',
-    },
-    copy: {
-      heroBadge: 'Dane z publicznego rejestru CEIDG',
-      heroTitle: 'Znajdź specjalistę w Twojej okolicy',
-      heroSubtitle: 'Otwarty katalog specjalistów. Bezpłatnie i bez rejestracji.',
-      searchPlaceholder: 'Szukaj po nazwisku, mieście lub firmie...',
-      itemsLabel: 'wpisów',
-      itemSingular: 'wpisu',
-    },
-    profiles: [],
-    cities: [],
-    sections: { afterHero: '', afterGrid: '' },
-  },
-
-  editor: {
-    fields: [
-      { key: 'brand.siteName', label: 'Nazwa serwisu', type: 'text', required: true },
-      { key: 'brand.description', label: 'Opis serwisu', type: 'textarea', required: true },
-      { key: 'copy.heroBadge', label: 'Badge nad nagłówkiem', type: 'text' },
-      { key: 'copy.heroTitle', label: 'Nagłówek hero', type: 'text', required: true },
-      { key: 'copy.heroSubtitle', label: 'Podtytuł hero', type: 'textarea' },
-      { key: 'copy.searchPlaceholder', label: 'Placeholder wyszukiwarki', type: 'text' },
-    ],
-    sections: [
-      { id: 'brand', title: 'Marka', fieldKeys: ['brand.siteName', 'brand.description'] },
-      { id: 'hero', title: 'Sekcja hero', fieldKeys: ['copy.heroBadge', 'copy.heroTitle', 'copy.heroSubtitle', 'copy.searchPlaceholder'] },
-    ],
-  },
-
-  dataSources: [
-    {
-      id: 'ceidg',
-      refresh: 'daily',
-      async fetch({ taxId }) {
-        if (!taxId) return {};
-        return { profiles: [] };
-      },
-    },
-  ],
-
-  routes(content) {
-    return [
-      { path: '/', cacheControl: 'public, s-maxage=300' },
-      {
-        path: '/:slug',
-        enumerate: () => content.profiles.map((p) => ({ slug: p.slug })),
-        cacheControl: 'public, s-maxage=300',
-      },
-    ];
-  },
-
-  render(req, ctx) {
-    if (req.params.slug) return renderProfile(req, ctx);
-    return renderIndex(req, ctx);
-  },
-
-  sitemap(content, baseUrl) {
-    const entries: SitemapEntry[] = [
-      { loc: `${baseUrl}/`, priority: 1.0, changefreq: 'daily' },
-    ];
-    for (const p of content.profiles) {
-      entries.push({ loc: `${baseUrl}/${p.slug}`, priority: 0.8, changefreq: 'weekly' });
-    }
-    return entries;
-  },
-
-  meta: {
-    locale: 'pl-PL',
-    description: 'Katalog specjalistów',
-    suggestedTheme: 'specialist-glossy',
-    tags: ['katalog', 'wizytówka', 'rejestr-publiczny'],
-  },
-};
-
-/* ─────────────── Render handlers (private) ─────────────── */
-
-function renderIndex(req: RenderRequest<CatalogContent>, ctx: RenderContext<CatalogTheme>): RenderResult {
-  const { content } = req;
-  const t = ctx.theme;
-  const q = (req.query.q ?? '').trim();
-  const page = Math.max(1, parseInt(req.query.p ?? '1', 10) || 1);
-
-  let filtered = content.profiles;
-  if (q) {
-    const ql = q.toLowerCase();
-    filtered = filtered.filter(
-      (p) =>
-        `${p.firstName} ${p.lastName}`.toLowerCase().includes(ql) ||
-        (p.city ?? '').toLowerCase().includes(ql) ||
-        (p.business?.name ?? '').toLowerCase().includes(ql),
-    );
-  }
-
-  const total = filtered.length;
-  const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
-  const slice = filtered.slice((page - 1) * PAGE_SIZE, page * PAGE_SIZE);
-
-  const hero = t.catalogHero({
-    badge: content.copy.heroBadge,
-    title: content.copy.heroTitle,
-    subtitle: content.copy.heroSubtitle,
-    searchAction: '/',
-    searchPlaceholder: content.copy.searchPlaceholder,
-    searchValue: q,
-  });
-
-  const stats = t.statBar([
-    { 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' },
-  ]);
-
-  const cityNav = t.categoryNav(
-    content.cities.slice(0, 8).map((c) => ({
-      href: `/?q=${encodeURIComponent(c.name)}`,
-      label: `${c.name} (${c.count})`,
-    })),
-    'Popularne miasta',
-  );
-
-  const cards = slice.map((p) => t.profileCard(p, `/${p.slug}`)).join('\n');
-  const grid = t.catalogGrid({
-    title: q ? `Wyniki dla „${t.esc(q)}" (${total})` : content.brand.siteName,
-    cards,
-  });
-
-  const pag = t.pagination({
-    current: page,
-    total: totalPages,
-    extraParams: q ? `&q=${encodeURIComponent(q)}` : '',
-  });
-
-  const body = `${hero}${stats}${content.sections.afterHero}${cityNav}${grid}${pag}${content.sections.afterGrid}`;
-
-  const jsonLd = {
-    '@context': 'https://schema.org',
-    '@type': 'WebSite',
-    name: content.brand.siteName,
-    url: ctx.baseUrl,
-    description: content.brand.description,
-  };
-
-  return {
-    body: t.layout({ title: content.brand.siteName, description: content.brand.description, jsonLd }, body),
-  };
-}
-
-function renderProfile(req: RenderRequest<CatalogContent>, ctx: RenderContext<CatalogTheme>): RenderResult {
-  const profile = req.content.profiles.find((p) => p.slug === req.params.slug);
-  if (!profile) {
-    return {
-      status: 404,
-      body: ctx.theme.layout({ title: 'Nie znaleziono' }, `<h1>404</h1><p>Brak takiego ${req.content.copy.itemSingular}.</p>`),
-    };
-  }
-
-  const t = ctx.theme;
-  const fullName = `${profile.firstName} ${profile.lastName}`;
-  const description = `${fullName} — ${profile.jobTitle}${profile.city ? ` w ${profile.city}` : ''}`;
-
-  const jsonLd = {
-    '@context': 'https://schema.org',
-    '@type': 'Person',
-    name: fullName,
-    jobTitle: profile.jobTitle,
-    url: `${ctx.baseUrl}/${profile.slug}`,
-    ...(profile.city && {
-      address: { '@type': 'PostalAddress', addressLocality: profile.city, addressCountry: 'PL' },
-    }),
-  };
-
-  return {
-    body: t.layout(
-      { title: `${fullName} | ${req.content.brand.siteName}`, description, jsonLd },
-      t.profileArticle(profile),
-    ),
-  };
-}

package/src/types.ts

@@ -1,232 +0,0 @@
-/**
- * @press2ai/engine — core types
- *
- * Cały design stoi na jednej zasadzie:
- *   render = pure function (content + theme + request) → html + meta
- * Dzięki temu ten sam template uruchamiamy w trzech trybach:
- *   - SSR: w CF Workerze multi-tenant (Faza 0, content z D1)
- *   - SSG: build statyczny (Faza 1, deploy do CF Pages / Codeberg Pages)
- *   - Browser: live preview w lokalnym edytorze
- * Engine jest tylko cienką warstwą routingu + ładowania content; cała
- * inteligencja siedzi w templatach.
- */
-
-import type { ZodType, ZodTypeDef } from 'zod';
-
-/**
- * Schema generic — `ZodType<C, ZodTypeDef, any>` zamiast `ZodType<C>` żeby
- * akceptować schematy z `.default()` (gdzie input-type ≠ output-type).
- * Bez tego template nie mógłby używać `z.array(...).default([])`.
- */
-type ContentSchema<C> = ZodType<C, ZodTypeDef, any>;
-
-/* ─────────────── Discriminator: Presence vs Commerce ─────────────── */
-
-/**
- * PresenceTemplate — wizytówki, blogi, portfolio, landingi.
- * Działa w Fazie 0 (trial multi-tenant) i Fazie 1 (sovereign).
- *
- * CommerceTemplate — sklepy. Wymaga Fazy 1 (własne konta usera u
- * operatorów płatności + na infrze). NIGDY nie tworzymy commerce
- * tenanta pod kontami platformy — gate prawny (PCI DSS, JPK, RODO).
- */
-export type OtwartyTemplate<C = unknown, T = unknown> =
-  | PresenceTemplate<C, T>
-  | CommerceTemplate<C, T>;
-
-interface BaseTemplate<C, T> {
-  /** Unikalny identyfikator templatu, np. 'trener', 'lekarz', 'blog'. */
-  id: string;
-  /** Nazwa do wyświetlenia w wizardzie / panelu. */
-  name: string;
-  /** Semver paczki npm — używane w wizardzie do migracji. */
-  version: string;
-
-  /** Zod schema kształtu treści. Engine waliduje przy zapisie. */
-  schema: ContentSchema<C>;
-  /** Domyślna treść dla świeżego tenanta (seed). */
-  defaultContent: C;
-
-  /** Auto-generowany formularz edytora (Faza 0). */
-  editor: EditorSchema;
-
-  /** Deklaratywne źródła danych (CEIDG, RPWDL, ...). Engine wywołuje. */
-  dataSources?: DataSource<C>[];
-
-  /** Wyliczenie istniejących URL-i dla danej treści. */
-  routes(content: C): RouteDescriptor<C>[];
-
-  /** Czysta funkcja renderowania. Wywoływana per request (SSR) lub per route (SSG). */
-  render(req: RenderRequest<C>, ctx: RenderContext<T>): RenderResult;
-
-  /** SEO + maszynowa odkrywalność. */
-  sitemap(content: C, baseUrl: string): SitemapEntry[];
-  robots?(content: C): string;
-  feed?(content: C, baseUrl: string): RssFeed | null;
-
-  /** Metadane templatu (nie treści). */
-  meta: TemplateMeta;
-}
-
-export interface PresenceTemplate<C = unknown, T = unknown> extends BaseTemplate<C, T> {
-  kind: 'presence';
-}
-
-export interface CommerceTemplate<C = unknown, T = unknown> extends BaseTemplate<C, T> {
-  kind: 'commerce';
-  /** Type-level gate: commerce zawsze wymaga Fazy 1. */
-  requiresPhase1: true;
-  /** Sloty providerów wypełniane przez wizard migracji. */
-  providers: CommerceProviders;
-  /** Demo mode — w Fazie 0 wolno pokazać podgląd, ale checkout musi być fake. */
-  demoMode?: { fakeCheckout: true };
-}
-
-/* ─────────────── Routes & rendering ─────────────── */
-
-export interface RouteDescriptor<C> {
-  /** Wzorzec URL-a, np. '/' albo '/blog/:slug'. */
-  path: string;
-  /** Dla SSG: wylicz wszystkie konkretne wartości parametrów z treści. */
-  enumerate?(content: C): Array<Record<string, string>>;
-  /** Hint dla CDN cache. */
-  cacheControl?: string;
-}
-
-export interface RenderRequest<C> {
-  /** Konkretna ścieżka URL (już dopasowana do route'a). */
-  path: string;
-  /** Dopasowane parametry route'a, np. { slug: 'anna-kowalska' }. */
-  params: Record<string, string>;
-  /** Query string, np. { q: 'warszawa', p: '2' }. */
-  query: Record<string, string>;
-  /** Treść tenanta (już załadowana przez engine). */
-  content: C;
-}
-
-export interface RenderContext<T> {
-  /** Bezwzględny URL bazowy (host + scheme), np. 'https://anna.otwarty-trener.pl'. */
-  baseUrl: string;
-  /** Theme (theme-specialist-glossy itd.). Type T określa kontrakt per template. */
-  theme: T;
-  /** Lokalizacja, np. 'pl-PL'. */
-  locale: string;
-  /** Tryb wykonania — pozwala templatom uniknąć dynamiki w SSG. */
-  mode: 'ssr' | 'ssg' | 'browser';
-}
-
-export interface RenderResult {
-  status?: number;
-  headers?: Record<string, string>;
-  body: string;
-}
-
-// HeadMeta usunięte w v0.3.0 — engine nigdy nie odczytywał `RenderResult.head`,
-// bo SEO meta-tagi i tak idą do `body` przez `theme.layout()`. Dwa źródła prawdy
-// (head field vs head w body) były źródłem rozjazdów (np. `<title>` w body
-// różnił się od title w deklarowanym head). Templaty teraz mają jedno źródło —
-// to które naprawdę trafia do HTML.
-
-/* ─────────────── Editor (Faza 0) ─────────────── */
-
-export interface EditorSchema {
-  fields: EditorField[];
-  sections?: EditorSection[];
-}
-
-export interface EditorField {
-  /** Ścieżka w content, np. 'profile.bio' (kropka = zagnieżdżenie). */
-  key: string;
-  label: string;
-  type: 'text' | 'textarea' | 'email' | 'url' | 'phone' | 'image' | 'select' | 'array' | 'date';
-  required?: boolean;
-  placeholder?: string;
-  help?: string;
-  /** Dla 'select'. */
-  options?: string[];
-  /** Dla 'array' — schemat pojedynczego elementu. */
-  itemSchema?: EditorField[];
-}
-
-export interface EditorSection {
-  id: string;
-  title: string;
-  fieldKeys: string[];
-}
-
-/* ─────────────── Data sources ─────────────── */
-
-export interface DataSource<C> {
-  id: string;
-  /** Engine wywołuje z kluczami identyfikacyjnymi (NIP, email, ...). */
-  fetch(input: DataSourceInput): Promise<Partial<C>>;
-  /** Częstotliwość auto-refresh w trybie sovereign (manual = nigdy). */
-  refresh?: 'manual' | 'daily' | 'weekly';
-}
-
-export interface DataSourceInput {
-  taxId?: string;
-  email?: string;
-  slug?: string;
-}
-
-/* ─────────────── SEO / discovery ─────────────── */
-
-export interface SitemapEntry {
-  loc: string;
-  lastmod?: string;
-  changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
-  priority?: number;
-}
-
-export interface RssFeed {
-  title: string;
-  link: string;
-  description: string;
-  items: RssItem[];
-}
-
-export interface RssItem {
-  title: string;
-  link: string;
-  guid: string;
-  pubDate: string;
-  description?: string;
-  content?: string;
-}
-
-/* ─────────────── Commerce providers ─────────────── */
-
-export interface CommerceProviders {
-  payment: ProviderSlot<PaymentProviderId>;
-  shipping?: ProviderSlot<ShippingProviderId>;
-  invoice?: ProviderSlot<InvoiceProviderId>;
-}
-
-export type PaymentProviderId = 'stripe' | 'p24' | 'payu' | 'blik' | 'paypal';
-export type ShippingProviderId = 'inpost' | 'dpd' | 'pickup' | 'manual';
-export type InvoiceProviderId = 'gus' | 'fakturownia' | 'manual';
-
-export interface ProviderSlot<T extends string> {
-  required: boolean;
-  available: T[];
-  default?: T;
-}
-
-/* ─────────────── Engine outputs ─────────────── */
-
-/** Plik wyprodukowany przez SSG build. */
-export interface BuildFile {
-  path: string; // np. '/index.html', '/blog/foo/index.html', '/sitemap.xml'
-  content: string;
-  contentType: string;
-}
-
-export interface TemplateMeta {
-  locale: string;
-  description: string;
-  /** Sugerowany theme — engine użyje go, jeśli user nie wybierze innego. */
-  suggestedTheme?: string;
-  /** Tagi do wyświetlania w katalogu templatów ('wizytówka', 'blog', 'sklep'). */
-  tags?: string[];
-}