@press2ai/engine 0.5.1 → 0.6.0

package/README.md

@@ -13,7 +13,7 @@ npm install @press2ai/engine
 ## Subpath exports
 
 - `@press2ai/engine` — core runtime + types
-- `@press2ai/engine/template-trener` — fitness/trainer vertical template
+- `@press2ai/engine/template-catalog` — universal catalog template (trener, terapeuta, lekarz, ...)
 - `@press2ai/engine/template-blog` — blog template
 - `@press2ai/engine/types` — TypeScript type exports
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@press2ai/engine",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Multi-tenant runtime + template contracts dla otwarty-* verticali. SSR na Cloudflare Workers, isomorphic renderer (SSG/browser w roadmapie).",
   "type": "module",
   "license": "MIT",
@@ -13,7 +13,7 @@
   },
   "exports": {
     ".": "./src/index.ts",
-    "./template-trener": "./src/template-trener.ts",
+    "./template-catalog": "./src/template-catalog.ts",
     "./template-blog": "./src/template-blog.ts",
     "./ceidg-vertical": "./src/ceidg-vertical.ts",
     "./types": "./src/types.ts"

package/src/ceidg-vertical.ts

@@ -15,7 +15,7 @@
  *   - Schema CEIDG (`leads`, `lead_pkd`, `lead_categories`, `cities`) jest
  *     hard-coded w queries — to jest *cel* tego helpera. „Generic vertical
  *     framework" nie istnieje, dopóki nie ma trzeciej rodziny niż otwarty-*.
- *   - Theme bundle (`TrenerTheme`) jest **input**, nie tworzony tutaj. Engine
+ *   - Theme bundle (`CatalogTheme`) jest **input**, nie tworzony tutaj. Engine
  *     nie zna theme-specialist-glossy. Wertykal podaje gotowy bundle (~10 LOC
  *     adaptera w landingu), helper tylko go wywołuje.
  *   - `loadContent` filtruje po `EXISTS lead_categories WHERE category=?`
@@ -34,11 +34,11 @@
 import { Hono } from 'hono';
 import { createSSRWorker } from './runtime/ssr';
 import {
-  trenerTemplate,
-  type TrenerContent,
-  type TrenerProfile,
-  type TrenerTheme,
-} from './template-trener';
+  catalogTemplate,
+  type CatalogContent,
+  type CatalogProfile,
+  type CatalogTheme,
+} from './template-catalog';
 
 /* ─────────────── Public types ─────────────── */
 
@@ -99,8 +99,8 @@ export interface VerticalConfig {
     afterHero?: string;
     afterGrid?: string;
   };
-  /** Theme bundle. Wertykal buduje adapter (Profile ↔ TrenerProfile) i podaje gotowy. */
-  theme: TrenerTheme;
+  /** Theme bundle. Wertykal buduje adapter (Profile ↔ CatalogProfile) i podaje gotowy. */
+  theme: CatalogTheme;
 }
 
 /* ─────────────── Implementation ─────────────── */
@@ -141,7 +141,7 @@ export function createVerticalApp(config: VerticalConfig): Hono<{ Bindings: Ceid
     GROUP BY c.name ORDER BY count DESC LIMIT 8`;
 
   // ─────────── Content loader ───────────
-  function leadToProfile(l: CeidgLead): TrenerProfile {
+  function leadToProfile(l: CeidgLead): CatalogProfile {
     return {
       slug: l.slug,
       firstName: l.first_name,
@@ -155,7 +155,7 @@ export function createVerticalApp(config: VerticalConfig): Hono<{ Bindings: Ceid
     };
   }
 
-  async function loadContent(_host: string, env: unknown): Promise<TrenerContent> {
+  async function loadContent(_host: string, env: unknown): Promise<CatalogContent> {
     const e = env as CeidgBindings;
     const [leadsRes, citiesRes] = await Promise.all([
       e.DB.prepare(leadsQuery + ' ORDER BY c.name, l.last_name').bind(category).all<CeidgLead>(),
@@ -180,7 +180,7 @@ export function createVerticalApp(config: VerticalConfig): Hono<{ Bindings: Ceid
     };
   }
 
-  const engine = createSSRWorker({ template: trenerTemplate, theme, loadContent });
+  const engine = createSSRWorker({ template: catalogTemplate, theme, loadContent });
 
   // ─────────── KV cache helper ───────────
   async function cached<T>(kv: KVNamespace, key: string, fn: () => Promise<T>): Promise<T> {

package/src/{template-trener.ts → template-catalog.ts}

@@ -1,10 +1,9 @@
 /**
- * template-trener — referencyjna implementacja PresenceTemplate.
+ * template-catalog — referencyjna implementacja PresenceTemplate.
  *
- * Zawiera pełen flow który dziś jest w OTWARTY-TRENER/landing/src/index.tsx,
- * tylko jako czyste funkcje renderujące zamiast handlerów Hono. Engine
- * wywoła render() per request (SSR) albo per route (SSG); template nie
- * wie który tryb jest aktywny i nie powinien tego sprawdzać.
+ * 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';
@@ -19,17 +18,16 @@ import type {
 /* ─────────────── 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.
- * Trener używa zestawu z @press2ai/theme-specialist-glossy.
  */
-export interface TrenerTheme {
+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: TrenerProfile, href: string): string;
-  profileArticle(p: TrenerProfile): string;
+  profileCard(p: CatalogProfile, href: string): string;
+  profileArticle(p: CatalogProfile): string;
   esc(s: string): string;
 }
 
@@ -39,7 +37,7 @@ const profileSchema = z.object({
   slug: z.string(),
   firstName: z.string(),
   lastName: z.string(),
-  jobTitle: z.string().default('Trener personalny'),
+  jobTitle: z.string().default('Specjalista'),
   city: z.string().optional(),
   bio: z.string().optional(),
   photo: z.string().url().optional(),
@@ -55,9 +53,9 @@ const profileSchema = z.object({
   social: z.record(z.string(), z.string()).default({}),
 });
 
-export type TrenerProfile = z.infer<typeof profileSchema>;
+export type CatalogProfile = z.infer<typeof profileSchema>;
 
-const trenerContentSchema = z.object({
+const catalogContentSchema = z.object({
   brand: z.object({
     siteName: z.string(),
     description: z.string(),
@@ -80,29 +78,29 @@ const trenerContentSchema = z.object({
   }).default({}),
 });
 
-export type TrenerContent = z.infer<typeof trenerContentSchema>;
+export type CatalogContent = z.infer<typeof catalogContentSchema>;
 
 const PAGE_SIZE = 12;
 
 /* ─────────────── Template ─────────────── */
 
-export const trenerTemplate: PresenceTemplate<TrenerContent, TrenerTheme> = {
+export const catalogTemplate: PresenceTemplate<CatalogContent, CatalogTheme> = {
   kind: 'presence',
-  id: 'trener',
-  name: 'Otwarty Trener',
+  id: 'catalog',
+  name: 'Otwarty Katalog',
   version: '1.0.0',
 
-  schema: trenerContentSchema,
+  schema: catalogContentSchema,
 
   defaultContent: {
     brand: {
-      siteName: 'Otwarty Trener',
-      description: 'Otwarta baza trenerów personalnych w Polsce. Dane z CEIDG.',
+      siteName: 'Otwarty Katalog',
+      description: 'Otwarta baza specjalistów w Polsce. Dane z CEIDG.',
     },
     copy: {
       heroBadge: 'Dane z publicznego rejestru CEIDG',
-      heroTitle: 'Znajdź trenera w Twojej okolicy',
-      heroSubtitle: 'Otwarty katalog trenerów. Bezpłatnie i bez rejestracji.',
+      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',
@@ -129,8 +127,6 @@ export const trenerTemplate: PresenceTemplate<TrenerContent, TrenerTheme> = {
 
   dataSources: [
     {
-      // CEIDG fetcher — w produkcji bije do dane.biznes.gov.pl, mapuje do
-      // profiles[]. Tu STUB — kontrakt: dostaje NIP, zwraca Partial<TrenerContent>.
       id: 'ceidg',
       refresh: 'daily',
       async fetch({ taxId }) {
@@ -168,7 +164,7 @@ export const trenerTemplate: PresenceTemplate<TrenerContent, TrenerTheme> = {
 
   meta: {
     locale: 'pl-PL',
-    description: 'Katalog trenerów personalnych',
+    description: 'Katalog specjalistów',
     suggestedTheme: 'specialist-glossy',
     tags: ['katalog', 'wizytówka', 'rejestr-publiczny'],
   },
@@ -176,7 +172,7 @@ export const trenerTemplate: PresenceTemplate<TrenerContent, TrenerTheme> = {
 
 /* ─────────────── Render handlers (private) ─────────────── */
 
-function renderIndex(req: RenderRequest<TrenerContent>, ctx: RenderContext<TrenerTheme>): RenderResult {
+function renderIndex(req: RenderRequest<CatalogContent>, ctx: RenderContext<CatalogTheme>): RenderResult {
   const { content } = req;
   const t = ctx.theme;
   const q = (req.query.q ?? '').trim();
@@ -222,7 +218,7 @@ function renderIndex(req: RenderRequest<TrenerContent>, ctx: RenderContext<Trene
 
   const cards = slice.map((p) => t.profileCard(p, `/${p.slug}`)).join('\n');
   const grid = t.catalogGrid({
-    title: q ? `Wyniki dla „${t.esc(q)}" (${total})` : 'Trenerzy',
+    title: q ? `Wyniki dla „${t.esc(q)}" (${total})` : content.brand.siteName,
     cards,
   });
 
@@ -247,7 +243,7 @@ function renderIndex(req: RenderRequest<TrenerContent>, ctx: RenderContext<Trene
   };
 }
 
-function renderProfile(req: RenderRequest<TrenerContent>, ctx: RenderContext<TrenerTheme>): RenderResult {
+function renderProfile(req: RenderRequest<CatalogContent>, ctx: RenderContext<CatalogTheme>): RenderResult {
   const profile = req.content.profiles.find((p) => p.slug === req.params.slug);
   if (!profile) {
     return {

package/src/engine-signature.ts

@@ -1,43 +0,0 @@
-/**
- * Engine signatures — pozostałe TRZY tryby wykonania (SSG + Browser).
- * SSR zostało wyciągnięte do runtime/ssr.ts (ma już prawdziwą implementację).
- * Te dwa pozostają jako `declare` do czasu implementacji w runtime/.
- */
-
-import type { OtwartyTemplate, BuildFile, RenderResult } from './types';
-
-/* ─────────────── Faza 1: SSG build do plików statycznych ─────────────── */
-
-export interface SSGBuildOpts<C, T> {
-  template: OtwartyTemplate<C, T>;
-  theme: T;
-  /** Treść jest stała na czas builda — z disku, z migracji z Faza 0, z CMS. */
-  content: C;
-  baseUrl: string;
-  /** Output adapter — pisanie plików, upload do CF Pages, push do Codeberg Pages. */
-  output: SSGOutput;
-}
-
-export interface SSGOutput {
-  write(file: BuildFile): Promise<void>;
-  finalize?(): Promise<void>;
-}
-
-export declare function createSSGBuild<C, T>(opts: SSGBuildOpts<C, T>): Promise<{ files: BuildFile[] }>;
-
-/* ─────────────── Browser: live preview w lokalnym edytorze ─────────────── */
-
-export interface BrowserRendererOpts<C, T> {
-  template: OtwartyTemplate<C, T>;
-  theme: T;
-  baseUrl: string;
-}
-
-export interface BrowserRenderer<C> {
-  /** Renderuje konkretną ścieżkę dla aktualnej treści — używane przez iframe preview. */
-  preview(content: C, path: string): RenderResult;
-  /** Lista wszystkich ścieżek wyliczonych z treści — używane przez side panel "Strony". */
-  listRoutes(content: C): string[];
-}
-
-export declare function createBrowserRenderer<C, T>(opts: BrowserRendererOpts<C, T>): BrowserRenderer<C>;