includio-cms 0.37.0 → 0.37.2

package/API.md

@@ -1,8 +1,8 @@
-# includio-cms — Public API v0.37.0
+# includio-cms — Public API v0.37.2
 
 > Auto-generated by `scripts/generate-api-md.ts`. Do not edit by hand.
 
-Entry points: **23** · Stable: **665** · Experimental: **4**
+Entry points: **23** · Stable: **715** · Experimental: **4**
 
 Tags:
 - `@public` — frozen for v1.0; semver-protected.
@@ -13,17 +13,59 @@ Tags:
 
 ### `includio-cms`
 
+- `article(input: ArticleInput): JsonLdNode`
+- `interface ArticleInput`
+- `blogPosting(input: ArticleInput): JsonLdNode`
+- `breadcrumbList(items: Array<{ name: string; url: string }>): JsonLdNode`
 - `interface EmailAdapter` — Contract for email adapters. Used by `better-auth` reset-password flow and form submission
+- `faqPage(items: Array<{ question: string; answer: string }>): JsonLdNode`
+- `interface GeoInput`
+- `imageNode(img: string | MediaFile): string | JsonLdNode` — Normalize an image to a URL string or an ImageObject with dimensions.
+- `jsonLdGraph(nodes: JsonLdNode | JsonLdNode[]): { '@context': 'https://schema.org'; '@graph': JsonLdNode[]; }` — Wrap node(s) into a schema.org
+- `type JsonLdNode = Record<string, unknown> & { '@type': string | string[] }`
+- `localBusiness(input: LocalBusinessInput): JsonLdNode`
+- `interface LocalBusinessInput`
+- `organization(input: OrganizationInput): JsonLdNode`
+- `interface OrganizationInput`
+- `interface PostalAddressInput`
+- `pruneEmpty(value: T): T` — Recursively drop undefined/null/'' and empty arrays/objects.
 - `type ResolvedSeo = { [K in keyof SeoFieldData]: K extends 'ogImage' ? string | MediaFile | undefined : string | unde...` — Normalized SEO data — localized values flattened by `language`. A stable
 - `resolveSeo(entry: { seo?: Record<string, unknown> } | Record<string,..., language?: string): ResolvedSeo` — Resolve `entry.seo` into flat fields, flattening localized objects by
 - `interface SendMailOptions`
+- `slugifyFilename(base: string): string` — Slugify a media file base name (extension handled by the caller).
+- `thing(type: string | string[], props: Record<string, unknown> = {}): JsonLdNode` — Build a schema.org node of `type` from `props`, pruning empty values.
+- `webPage(input: WebPageInput): JsonLdNode`
+- `interface WebPageInput`
+- `website(input: WebSiteInput): JsonLdNode`
+- `interface WebSiteInput`
 
 ### `includio-cms/core`
 
+- `article(input: ArticleInput): JsonLdNode`
+- `interface ArticleInput`
+- `blogPosting(input: ArticleInput): JsonLdNode`
+- `breadcrumbList(items: Array<{ name: string; url: string }>): JsonLdNode`
 - `interface EmailAdapter` — Contract for email adapters. Used by `better-auth` reset-password flow and form submission
+- `faqPage(items: Array<{ question: string; answer: string }>): JsonLdNode`
+- `interface GeoInput`
+- `imageNode(img: string | MediaFile): string | JsonLdNode` — Normalize an image to a URL string or an ImageObject with dimensions.
+- `jsonLdGraph(nodes: JsonLdNode | JsonLdNode[]): { '@context': 'https://schema.org'; '@graph': JsonLdNode[]; }` — Wrap node(s) into a schema.org
+- `type JsonLdNode = Record<string, unknown> & { '@type': string | string[] }`
+- `localBusiness(input: LocalBusinessInput): JsonLdNode`
+- `interface LocalBusinessInput`
+- `organization(input: OrganizationInput): JsonLdNode`
+- `interface OrganizationInput`
+- `interface PostalAddressInput`
+- `pruneEmpty(value: T): T` — Recursively drop undefined/null/'' and empty arrays/objects.
 - `type ResolvedSeo = { [K in keyof SeoFieldData]: K extends 'ogImage' ? string | MediaFile | undefined : string | unde...` — Normalized SEO data — localized values flattened by `language`. A stable
 - `resolveSeo(entry: { seo?: Record<string, unknown> } | Record<string,..., language?: string): ResolvedSeo` — Resolve `entry.seo` into flat fields, flattening localized objects by
 - `interface SendMailOptions`
+- `slugifyFilename(base: string): string` — Slugify a media file base name (extension handled by the caller).
+- `thing(type: string | string[], props: Record<string, unknown> = {}): JsonLdNode` — Build a schema.org node of `type` from `props`, pruning empty values.
+- `webPage(input: WebPageInput): JsonLdNode`
+- `interface WebPageInput`
+- `website(input: WebSiteInput): JsonLdNode`
+- `interface WebSiteInput`
 
 ### `includio-cms/core/server`
 
@@ -332,8 +374,10 @@ Tags:
 - `const Image: LegacyComponentType`
 - `isImageFieldData(media: MediaFieldData): media is ImageFieldData`
 - `isVideoFieldData(media: MediaFieldData): media is VideoFieldData`
+- `const JsonLd: LegacyComponentType`
 - `const Media: LegacyComponentType`
 - `const Preview: LegacyComponentType`
+- `const Seo: LegacyComponentType`
 - `setCustomFields(defs: Map<string, CustomFieldDefinition>): <inferred>`
 - `setPreferMp4(value: boolean): <inferred>`
 - `setRemotes(data: typeof remotes): <inferred>`
@@ -343,6 +387,8 @@ Tags:
 
 ### `includio-cms/sveltekit/server`
 
+- `buildRobots(options: RobotsOptions = {}): string` — Build a robots.txt document. Defaults to allow-all + optional sitemap link.
+- `buildSitemap(entries: SitemapEntry[]): string` — Build a sitemap.xml document from a list of URL entries.
 - `cmsLayoutLoad(event: RequestEvent): <inferred>` — Returns `cmsContext` from `event.locals` for use in a SvelteKit layout
 - `countEntries(opts: CountEntriesOptions): Promise<number>` — Count entries matching the same filters as `resolveEntries`, without
 - `type CountEntriesOptions = Omit< ResolveEntriesOptions, 'limit' | 'offset' | 'populate' | 'orderBy' | 'dataOrderBy' >`
@@ -365,7 +411,10 @@ Tags:
 - `resolveEntry(opts: ResolveEntryOptions): Promise<Entry | null>` — Fetch a single populated Entry.
 - `interface ResolveEntryOptions`
 - `type ResolveStatus = 'published' | 'draft' | 'scheduled'` — Status filter for `resolveEntry`/`resolveEntries`/`countEntries`.
+- `interface RobotsOptions`
+- `interface RobotsRule`
 - `sendMail(options: SendMailOptions): Promise<void>` — Send an email through the configured CMS email adapter. Thin convenience
+- `interface SitemapEntry`
 
 ### `includio-cms/db-postgres`
 
@@ -688,24 +737,25 @@ Tags:
 - `interface BookingStatusItem`
 - `type BookingTx = Parameters<Parameters<ReturnType<typeof getBookingDb>['transaction']>[0]>[0]` — Exact drizzle transaction handle, derived from the booking db's `transaction`.
 - `class BookingValidationError` — Thrown when a booking fails capacity (core) or the client `validateBooking` seam.
-- `createBooking(input: CreateBookingInput, opts: { now?: Date } = {}): Promise<{ booking: typeof bookingsTable.$inferSelect; accessToken: string }>` — Create a booking (public self-serve or staff). Validates catalog capacity +
+- `createBooking(input: CreateBookingInput, opts: { now?: Date; actor?: PriceActor } = {}): Promise<{ booking: typeof bookingsTable.$inferSelect; accessToken: string }>` — Create a booking (public self-serve or staff). Validates catalog capacity +
 - `createBookingHandler(): { POST: RequestHandler }` — Public self-serve booking creation. Mount at `POST /api/booking`.
 - `createDepositPayment(bookingId: string): Promise<{ redirectUrl: string | null; status: 'redirect' | 'manual' | 'error'...` — Create the deposit payment for a freshly-created booking: ask the first
-- `createInstallmentPayment(bookingId: string, amount: number): Promise<{ paymentLink: string | null }>` — Generate an installment/balance payment link for an arbitrary amount (staff or
+- `createInstallmentPayment(bookingId: string, opts: InstallmentPaymentOptions): Promise<{ paymentLink: string | null }>` — Generate an installment/balance payment link. Records a pending ledger row keyed
 - `createMaintenanceHandler(): { POST: RequestHandler }` — Secured external trigger for booking maintenance — the swap-in for the
 - `createPortalHandler(): { GET: RequestHandler; POST: RequestHandler }` — Self-service portal. Mount at `GET|POST /api/booking/portal/[token]`.
 - `createWebhookHandler(): { POST: RequestHandler }` — Payment-provider webhook. Mount at `POST /api/booking/webhook/[provider]`.
 - `editBooking(bookingId: string, changes: BookingEditChanges, opts: { actor: 'staff' | 'portal'; now?: Date }): Promise<typeof bookingsTable.$inferSelect>` — Edit a booking (staff or portal). Recomputes totals per-participant + derived
 - `getBookingDb(): <inferred>` — Returns the Drizzle handle, asserting the postgres adapter is in use.
 - `getBookingMaintenanceStatus(): { running: boolean; lastRun: Date | null }`
+- `interface InstallmentPaymentOptions`
 - `listBookingAdjustments(bookingId: string): Promise<BookingAdjustment[]>` — List all adjustments (active + voided) for a booking, newest first.
 - `pickEmailTemplate(kind: BookingEmailKind): string` — Template file name for a kind (1:1 — kept as a function for future indirection).
-- `portalAddTrips(token: string, additions: Array<{ tripRef: string; unitPrice: number; as...): <inferred>` — Self-service dobieranie wycieczki: doczytaj obecny stan, scal z `additions`
+- `portalAddTrips(token: string, additions: Array<{ tripRef: string; assignments: string[] }>): <inferred>` — Self-service dobieranie wycieczki: doczytaj obecny stan, scal z `additions`
 - `portalEdit(token: string, changes: BookingEditChanges): <inferred>` — Portal self-service edit (actor:'portal' guards). Throws → handler maps to 409/400.
-- `portalPay(token: string, amount: number): <inferred>` — Portal: create an installment/balance payment link.
+- `portalPay(token: string): <inferred>` — Portal: create a balance payment link. The amount is NOT taken from the request —
 - `portalUpdateParticipant(token: string, assignmentId: string, data: Record<string, unknown>): <inferred>` — Portal self-service: customer fills their own participant data. Verifies the
 - `portalView(token: string): <inferred>` — Portal view: booking + items + participants + ledger (no staff data).
-- `priceFromExistingRows(tx: BookingTx, bookingId: string, config: ResolvedBookingConfig, now: Date): Promise<ParticipantPriceResult>` — Price a booking from its CURRENTLY persisted people/items/assignments (no
+- `priceFromExistingRows(tx: BookingTx, bookingId: string, config: ResolvedBookingConfig): Promise<ParticipantPriceResult>` — Price a booking from its CURRENTLY persisted people/items/assignments (no
 - `processDueExpirations(now: Date = new Date()): Promise<{ abandoned: number; forfeited: number }>` — Auto-cancel expired bookings: abandoned drafts (deposit hold lapsed) and
 - `processDueReminders(now: Date = new Date()): Promise<number>` — Send all due reminders (unsent, `scheduledFor <= now`) via the email adapter,
 - `readTripCapacity(tripRef: string): Promise<number | null>` — Read a trip's seat capacity from the catalog collection.

package/CHANGELOG.md

@@ -3,6 +3,48 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.37.2 — 2026-07-16
+
+Powierzchnia SEO/AEO rdzenia — reużywalne helpery, które raz naprawione w rdzeniu działają u każdego klienta (wyszły z wdrożenia SEO u pod-zwrotnikami). W tym samym patchu domyka się też łatka bezpieczeństwa bookingu (kwota płatności).
+
+### Added
+- **Buildery JSON-LD (schema.org) w `includio-cms/core`.** Typowane, czyste funkcje: `organization`, `localBusiness`, `website`, `webPage`, `breadcrumbList`, `article`, `blogPosting`, `faqPage` + generyk `thing` i `jsonLdGraph`. Opt-in — nic nie emitują domyślnie. `undefined`/puste wartości wypadają z outputu, więc częściowe dane dają poprawny minimalny JSON-LD. Bespoke typy (np. `TouristTrip + Offer`, `Product`) składasz po stronie projektu przez `thing("TouristTrip", { ... })` — rdzeń zostaje generyczny.
+- **Komponent `<JsonLd>` w `includio-cms/sveltekit`.** Renderuje `<script type="application/ld+json">` w `<svelte:head>` (SSR), escapuje `<` → breakout ze `<script>` jest niemożliwy. Przyjmuje obiekt albo tablicę (np. wynik `jsonLdGraph`).
+- **`buildSitemap` / `buildRobots` w `includio-cms/sveltekit/server`.** Czyste buildery: `buildSitemap(entries)` → string `sitemap.xml` (URL-e XML-escaped, `lastmod` `Date`→ISO lub string, opcjonalne `changefreq`/`priority`), `buildRobots(options)` → `robots.txt` (domyślnie allow-all + link do sitemapy, konfigurowalne reguły). Projekt posiada route i wpina helper: `export const GET = async () => new Response(buildSitemap(entries), { headers: { "content-type": "application/xml" } });`.
+
+### Fixed
+- **Slugifikacja nazw plików mediów.** Upload i zmiana nazwy przepuszczają basename przez `slugifyFilename` (nowy helper w `includio-cms/core`): `"IMG-1234 (1).jpeg"` → `img-1234-1.jpeg`, polskie znaki transliterowane, spacje/wielkość/nawiasy usunięte. Tylko nowe pliki — istniejące URL-e w bazie nietknięte (bez migracji). Cap 200 znaków, path-traversal niemożliwy (slug nie zawiera `/` ani `.`).
+- **`<Seo>` dopełniony i wyeksportowany z `includio-cms/sveltekit`.** Wcześniej komponent istniał, ale nie był eksportowany (martwy). Bugfix: `og:url` i `og:type` używają `property=` zamiast `name=` (wymóg Open Graph). Nowe propsy: `ogType` (domyślnie `website`; `article` dokłada `article:published_time`/`modified_time`/`author`/`section`/`tag`), `noindex` (→ `<meta name="robots" content="noindex">`), `siteName` (→ `og:site_name`). `ogImage` typu `MediaFile` emituje `og:image:width`/`height`/`alt`.
+- **Typografia — łamanie sierot przyimkowych.** `fixOrphans` wstawia NBSP nie tylko po jednoliterowych spójnikach (`i/w/z/o/u/a/e`), ale też po krótkich przyimkach (`do na od po we za ze ku nad pod bez dla przy`). Lista konfigurowalna parametrem `words` + eksport `DEFAULT_ORPHAN_WORDS`. Domyślnie konserwatywnie (bez spójników typu `oraz/lub`), żeby nie NBSP-ować za dużo.
+- **Bezpieczeństwo (booking): kwota dopłaty przestaje pochodzić z żądania HTTP.** Domknięcie łuku 0.37.1 (cena szła z katalogu, ale kwota wpłaty — nie): `portalPay` podawał `amount` z ciała żądania prosto do `createInstallmentPayment`, bez konfrontacji z saldem — przeglądarka dyktowała kwotę (nadpłata do ręcznego zwrotu albo link na grosz). Bramka kwotowa oparta na aktorze (bliźniak bramki cenowej): `portal` NIE dyktuje (serwer obciąża `totals.balance`, fail-closed gdy brak salda), `staff` może. Portalowa wpłata zapisuje się teraz z `createdBy` aktora — nie zahardkodowanym `staff` (koniec kłamstwa w audycie).
+- **Booking: `ledger.balance` przestaje gubić rabaty.** `portalView` liczył `ledger` z `totals.gross` → `balance = gross − paid`, pomijając `discount`/`surcharge`/`manualDiscount`; portal pokazywał dwa różne salda i przycisk płatności brał gorzej policzone. Teraz `toPortalView` karmi `ledgerSummary` wartością netto (`netOf(totals)`), więc `ledger.balance === totals.balance`.
+
+### Breaking
+- **`createInstallmentPayment(bookingId, amount)` → `createInstallmentPayment(bookingId, { actor, amount? })`.** `actor: "portal" | "staff"` jest wymagany. Dla `portal` kwota jest ignorowana (serwer obciąża saldo); dla `staff` podajesz `amount`. `portalPay(token, amount)` → `portalPay(token)` (kwota nie jest już parametrem). Dotyczy tylko konsumentów wołających te funkcje bezpośrednio — ścieżka przez handler portalu/remote admina zaktualizowana w rdzeniu.
+
+## 0.37.1 — 2026-07-14
+
+Dwie łatki cenowe w bookingu. (1) Cena rezerwacji przestaje pochodzić z żądania HTTP — do 0.37.0 publiczne endpointy przyjmowały `unitPrice` prosto z ciała żądania i nikt nie konfrontował go z katalogiem, więc wyprawę dało się zarezerwować za grosz. (2) Data wyceny zostaje zamrożona na rezerwacji — dotąd każde jej dotknięcie (edycja, ale też zaksięgowanie korekty) przeliczało reguły zależne od czasu wg DZISIEJSZEJ daty, przez co early-bird sprzed miesięcy cicho znikał i klient robił się winien pieniądze.
+
+### Added
+- `defineBooking({ resolvePrice })` — serwerowy szew zwracający cenę bazową (dorosłego) pozycji katalogu w groszach. Rdzeń nie zna kształtu katalogu, więc cenę podaje projekt: `resolvePrice: async (tripRef) => Math.round(Number((await resolveEntry({ id: tripRef, status: "published" }))?.price ?? 0) * 100)`.
+- Model zaufania oparty na aktorze: `createBooking(input, { actor })` przyjmuje `public | portal | staff`. Domyślny aktor to `public` (niezaufany) — pominięcie parametru nie otwiera dziury. Zalogowana obsługa (`staff`) nadal może podać cenę ręcznie: korekta i rabat negocjowany telefonicznie zostają możliwe.
+- Typ `PricedCreateInput` wymusza kolejność: rezerwacji nie da się zbudować z pozycji, której nie wyceniła bramka — pilnuje tego kompilator, nie dyscyplina.
+
+### Fixed
+- **Bezpieczeństwo (data wyceny).** Nowa kolumna `bookings.priced_at` zamraża moment wyceny. `editBooking` i `priceFromExistingRows` (ścieżka korekt — `adjustments.ts:65` i `:155`) liczą teraz early-bird na tę datę, nie na `new Date()`. Wcześniej wystarczyło, że obsługa zaksięguje dopłatę ustaloną telefonicznie tydzień przed wylotem, a rabat za wczesną rezerwację przepadał. `priceFromExistingRows` straciło parametr `now` — kompilator nie pozwoli już podać tam zegara.
+- Rezerwacje sprzed 0.37.1 mają `priced_at = NULL` i wyceniają się z `created_at` — dokładnie tym, czym było wtedy `now`. Zero migracji danych, zero zmiany zachowania.
+- **Bezpieczeństwo (ceny).** Trzy publiczne drogi wpuszczały cenę z zewnątrz: tworzenie rezerwacji (`createBookingHandler`), dokładanie wycieczki przez portal (`add-trips`) i portalowa edycja pozycji (`portalEdit` → `editBooking`). Bramka stoi teraz w rdzeniu (`createBooking`/`editBooking`), nie w handlerach, więc każdy przyszły publiczny endpoint jest chroniony domyślnie.
+- Cena pozycji już zapisanej w rezerwacji jest brana z jej `unitPriceSnapshot`, a nie przeliczana z katalogu — dotknięcie rezerwacji przez portal nie podniesie klientowi ceny, gdy cennik w międzyczasie poszedł w górę.
+- Odczyt katalogu w `editBooking` odbywa się przed otwarciem transakcji: szew klienta robi własne I/O, a wołany pod blokadą `FOR UPDATE` trzymałby wiersz rezerwacji i sięgał po drugie połączenie z tej samej puli.
+- Ceny ujemne i niecałkowite (ułamek grosza) są odrzucane — również dla obsługi.
+
+### Breaking
+- Nowa kolumna `bookings.priced_at` — wymagana migracja (`drizzle-kit push`). Nullable, bez backfillu.
+- **`defineBooking({ resolvePrice })` jest teraz wymagany, gdy booking wystawia publiczne endpointy** (`createBookingHandler`, portal). Bez niego rdzeń odmawia wyceny (fail-closed) zamiast po cichu zaufać cenie z żądania. Instalacje używające wyłącznie panelu admina działają bez zmian.
+- `BookingItemInput.unitPrice` jest opcjonalne i **honorowane wyłącznie dla `actor: "staff"`**. Dla klienta końcowego jest ignorowane — cenę ustala katalog.
+- Publiczne API klienta: `createBookingClient().addTrips(token, additions)` oraz `useBooking().addTrips(additions)` nie przyjmują już `unitPrice` w pozycjach (`{ tripRef, assignments }`). Storefronty przekazujące cenę muszą ją usunąć z ładunku — była i tak ignorowana po stronie serwera.
+
 ## 0.37.0 — 2026-06-17
 
 Moduły-nakładki + context switcher: shop i booking jako równorzędne, opcjonalne moduły rozszerzające rdzeń CMS (model „WooCommerce na WordPressie"). Zunifikowany rejestr `config.modules`, przełącznik kontekstu w adminie (Treści / Sklep / Rezerwacje) dla czytelniejszego UI, per-moduł dashboard. Shop przepięty na nowy kontrakt `CMSModule` (dowód generyczności #1), booking dodany jako drugi moduł biblioteki z pełnym rdzeniem domenowym (wycena/state machine/księga płatności) — dowód #2. Booking write-flow + portal self-service domknięte: tworzenie (public+staff), zadatek + webhook idempotentny, pełna edycja self-service (recompute/pojemność/„nie poniżej wpłaconego”), maile + przypomnienia, cron bez-infra (in-process loop + secured endpoint), strefa obsługi w adminie, scaffold `--booking`. Plan: `docs/superpowers/plans/2026-06-18-booking-write-flow-portal.md`, spec: `docs/superpowers/specs/2026-06-18-booking-write-flow-portal-design.md`.

package/DOCS.md

@@ -1,4 +1,4 @@
-# Includio CMS Documentation (v0.37.0)
+# Includio CMS Documentation (v0.37.2)
 
 > This file is auto-generated from the docs site. For the latest version, update the package.
 

package/ROADMAP.md

@@ -35,8 +35,39 @@
 - [x] `[feature]` `[P1]` Slug first-class + SEO v1.0 freeze (0.26.0) — `resolveSeo` public (`includio-cms/core`), `seoFieldDescriptor` SSOT (Zod+TS drift-guard), admin URL un-hardcode (`slugPath.ts` pure resolver, no `seo`-field requirement), `SlugField`/`SeoField`/`SeoFieldData` `@public` v1.0-frozen <!-- files: src/lib/core/fields/slugPath.ts, src/lib/core/fields/seoFieldDescriptor.ts, src/lib/core/fields/resolveSeo.ts, src/lib/types/fields.ts, src/lib/admin/client/collection/collection-entries.svelte, src/lib/updates/0.26.0/ -->
 - [x] `[feature]` `[P2]` Soft-delete zamówień admin-only (0.34.0) — ukrycie zamówienia z listy bez utraty danych (`deleted_at`/`deleted_by`), kosz + przywracanie, guard `decideOrderDeletion` (safe-statuses + faktura), auto-restore przy płatności, zwolnienie rezerwacji stocku, `requireRole('admin')` <!-- files: src/lib/shop/server/orders.ts, src/lib/db-postgres/schema/shop/order.ts, src/lib/admin/remote/shop.remote.ts, src/lib/admin/client/shop/{shop-order-detail-page,shop-orders-list-page,restore-order-cell}.svelte, src/lib/updates/0.34.0/ -->
 
+## 0.37.1 — Bramka cenowa (bezpieczeństwo)
+
+- [x] `[fix]` `[breaking]` `[P0]` **Data wyceny zamrożona na rezerwacji** (`bookings.priced_at`). Dotąd cena bazowa była zamrożona, ale data — nie: `editBooking` i `priceFromExistingRows` (ścieżka **korekt**) przeliczały reguły zależne od czasu wg `new Date()`. Obsługa księgowała dopłatę ustaloną telefonicznie tydzień przed wylotem → `daysUntil(anchor, now)` spadało poniżej progu → **early-bird sprzed miesięcy cicho znikał, a klient robił się winien pieniądze**. Bomba tykała sama, bez żadnej zmiany cennika. Rezerwacje sprzed 0.37.1: `priced_at = NULL` → fallback na `created_at` (zero migracji danych). Pełny snapshot **wartości** polityki (`pricing_snapshot`) zostaje w 0.38.0 §4.4 — wymaga świadomej zmiany cennika przez klientkę, więc da się ją uprzedzić.
+- [x] `[fix]` `[breaking]` `[P0]` **Cena rezerwacji przestaje pochodzić z żądania HTTP.** Do 0.37.0 trzy publiczne drogi wpuszczały `unitPrice` z ciała żądania i nikt nie konfrontował go z katalogiem (`create-handler.ts:37`, portalowe `add-trips`, portalowe `edit` → `editBooking`) — wyprawę dało się zarezerwować za grosz. Bramka stoi teraz w rdzeniu (`createBooking`/`editBooking`), oparta na aktorze: `public`/`portal` nie dyktują ceny (nowa pozycja → szew `resolvePrice` z katalogu, istniejąca → jej `unitPriceSnapshot`), `staff` nadal może korygować ręcznie. Domyślny aktor to `public`, więc przyszły publiczny endpoint jest bezpieczny bez pamiętania o niczym. Fail-closed: brak `resolvePrice` = odmowa wyceny.
+
+## 0.37.2 — SEO/AEO surface + kwota płatności
+
+> Domknięcie tego samego łuku co 0.37.1: **cena** przestała pochodzić z żądania HTTP, ale **kwota płatności** wciąż pochodzi.
+> Zgłoszone z pod-zwrotnikami (2026-07-14) — klient z rabatem pakietowym płacił w portalu za dużo. Konsument załatał się u siebie
+> (`totals.balance` zamiast `ledger.balance`), ale przyczyna siedzi w rdzeniu i każdy kolejny konsument wdepnie w to samo.
+
+- [x] `[fix]` `[P0]` **Kwota dopłaty przestaje pochodzić z żądania HTTP.** `portalPay(token, amount)` podaje `amount` prosto do `createInstallmentPayment(bookingId, amount)` (`payments.ts:149`), a ta wkłada go do `totalGross` adaptera i insertuje `booking_payments` — **bez żadnej konfrontacji z `totals.balance`**. Przeglądarka dyktuje, ile zapłaci: może za dużo (nadpłata do zwrotu ręcznego), może grosz (link płatności na 0,01 zł). Bramka z 0.37.1 stanęła na `unitPrice`, ale nie na kwocie wpłaty. Fix: kwotę wyznacza/weryfikuje serwer względem `totals.balance` (aktor `portal` nie dyktuje kwoty, `staff` może — symetrycznie do bramki cenowej), fail-closed przy rozjeździe. Przy okazji: portalowa wpłata zapisuje się z `createdBy: 'staff'` (`payments.ts:187`), co kłamie w audycie. <!-- files: src/lib/booking/server/portal.ts, src/lib/booking/server/payments.ts -->
+- [x] `[fix]` `[P0]` **`ledger.balance` gubi rabaty — i kusi nazwą.** `portalView` woła `ledgerSummary(booking.totals.gross, payments)` (`server/portal.ts:48`), a `ledgerSummary` liczy `balance = gross - paid` (`ledger.ts:87`), z pominięciem `discount` / `surcharge` / `manualDiscount`. Autorytatywne jest `totals.balance` (`netOf(base) - paid`, `totals.ts:73`) i portalView zwraca je obok — więc widok podaje konsumentowi **dwa różne salda, a to gorzej policzone nosi bardziej oczywistą nazwę**. Efekt u konsumenta: portal pokazywał „Pozostało 532 zł" i „Do dopłaty 610 zł" na jednym ekranie, a przycisk płatności brał tę drugą. Fix: `ledgerSummary` liczy saldo z netto (albo `portalView` przestaje zwracać `ledger.balance` i zostawia sam `overpaid`). Test regresyjny: rezerwacja z rabatem → `ledger.balance === totals.balance`. <!-- files: src/lib/booking/ledger.ts, src/lib/booking/server/portal.ts, src/lib/booking/totals.ts -->
+
+> **SEO/AEO surface** (bundlowane w tym samym patchu, 2026-07-16). Reużywalne w rdzeniu — raz naprawione, działa u każdego klienta. Spec: `docs/superpowers/specs/2026-07-15-seo-aeo-core-surface-design.md`, plan: `docs/superpowers/plans/2026-07-16-seo-aeo-core-surface.md`.
+
+- [x] `[feature]` `[P1]` **Buildery JSON-LD + `<JsonLd>`** — typowane, czyste buildery schema.org w `includio-cms/core` (`organization`/`localBusiness`/`website`/`webPage`/`breadcrumbList`/`article`/`blogPosting`/`faqPage` + generyk `thing`/`jsonLdGraph`) i komponent `<JsonLd>` (SSR w `<svelte:head>`, escape `<`). Opt-in. <!-- files: src/lib/core/fields/jsonLd/, src/lib/sveltekit/components/json-ld.svelte -->
+- [x] `[fix]` `[P1]` **Slugifikacja nazw plików mediów** — `slugifyFilename` w core; `files-local` slugifikuje basename przy uploadzie/rename (tylko nowe pliki, non-breaking). <!-- files: src/lib/core/fields/slugifyFilename.ts, src/lib/files-local/index.ts -->
+- [x] `[fix]` `[P1]` **`<Seo>` dopełniony + wyeksportowany** — export z `sveltekit`; bugfix `og:url`/`og:type` `name→property`; `ogType`/`noindex`/`siteName`/`article` props; og:image width/height/alt z `MediaFile`. <!-- files: src/lib/sveltekit/components/seo.svelte, src/lib/sveltekit/index.ts -->
+- [x] `[fix]` `[P2]` **fixOrphans: przyimki wieloliterowe** — domyślny zestaw rozszerzony o 2–3-literowe przyimki, konfigurowalny `words` param + `DEFAULT_ORPHAN_WORDS`. <!-- files: src/lib/core/server/fields/utils/fixOrphans.ts -->
+- [x] `[feature]` `[P1]` **`buildSitemap`/`buildRobots`** — czyste buildery w `sveltekit/server`; projekt posiada route. <!-- files: src/lib/sveltekit/server/sitemap.ts -->
+
 ## 0.38.0 — Moduły: kontrakt vs polityka
 
+> **WSTRZYMANE (2026-07-14).** Łuk jest dojrzały, ale klientka nie zobaczy z niego nic, a produktyzacja
+> (`module_settings`, `AdminRouter`, kupony) zwraca się dopiero przy **drugim kliencie z bookingiem**.
+> Wracamy, gdy taki się pojawi — wtedy abstrakcje wyjdą z dwóch realnych przypadków, nie z jednego.
+> Wyjątek już zrobiony: kawałek 3a (jądro reguł) leży zrebase'owany na `feat/pricing-rules-kernel`.
+> Poprawka do wprowadzenia przy powrocie: pozycja o typach wypraw twierdzi, że „moduł ma wnosić je sam" —
+> **to jest błędne**. `tripType` to pojęcie domenowe klienta (klient nr 3 może wynajmować kajaki).
+> Moduł może wnieść MECHANIZM (rejestr typów pól + generator pola `blocks` + adapter + headless front),
+> nie POJĘCIE.
+
 Spec: `docs/superpowers/specs/2026-07-13-moduly-kontrakt-vs-polityka-design.md`. Kolejność i uzasadnienia tam.
 
 - [x] `[feature]` `[P0]` Kawałek 3a — jądro reguł w rdzeniu (`core/rules`) + cennik jako kategorie uczestnika; golden testy parytetu ze starym silnikiem. Branch `feat/pricing-rules-kernel`.
@@ -72,6 +103,7 @@ Spec: `docs/superpowers/specs/2026-07-13-moduly-kontrakt-vs-polityka-design.md`.
 
 ## Backlog
 
+- [ ] `[feature]` `[P2]` **Panel SEO w sidebarze admina (Yoast-like)** — osobny brainstorm/spec. Guided, niestechniczny panel (odwrotność przytłaczającego Yoasta, on-brand): globalna konfiguracja SEO, per-wpisowy box (snippet preview, noindex toggle, focus keyword → wtedy świadome rozszerzenie pola `seo`), pobranie sitemapy (nakładka na `buildSitemap`). **Przekierowania (redirects)** prawdopodobnie własny spec (tabela DB + hook 301/302 + CRUD). Szwy pod to = SEO surface 0.37.2.
 - [ ] `[fix]` `[P1]` Wyciek puli połączeń DB w dev (HMR) — pojedynczy proces `vite dev` konsumenta trzymał **100 połączeń** do Postgresa (cały `max_connections`), po czym baza odbijała wszystko: `FATAL: sorry, too many clients already` (zaobserwowane 2026-07-13 na pod-zwrotnikami). Hipoteza: każde przeładowanie modułu przez HMR tworzy nowy klient `postgres.js` (pula domyślnie 10), a stary nie jest zamykany — 10 przeładowań wyczerpuje limit. Sprawdzić zamykanie klienta w `import.meta.hot.dispose` / singleton na `globalThis` w adapterze. Dotyka każdego, kto dłużej pracuje w dev. <!-- files: src/lib/db-postgres/index.ts -->
 - [ ] `[chore]` `[P1]` CMS doctor — `validateLayout()` jest napisany i przetestowany, ale nie jest wołany z żadnego miejsca produkcyjnego: literówka w nazwie pola w tabie przechodzi po cichu (pole ląduje w orphanach). Podpiąć go do `defineConfig` obok `validatePreviews`, dołożyć `pnpm cms check` w CLI i zestaw reguł zdrowia configu (martwe pola, `pathTemplate` bez `previewUrl`/`previews`, itp.). <!-- files: src/lib/core/fields/layoutUtils.ts, src/lib/sveltekit/config.ts, src/lib/core/config/, src/lib/cli/index.ts -->
 - [ ] `[feature]` `[P2]` Date/datetime field — przebudowa na shadcn-svelte (bits-ui Calendar/DatePicker) zamiast natywnego inputu. Zgłoszone w QA Etap 5a (4/5); funkcjonalnie OK, odłożone jako osobny redesign pola daty. <!-- files: src/lib/admin/components/fields/date-field.svelte, datetime-field.svelte -->

package/dist/admin/remote/booking.remote.d.ts

@@ -24,6 +24,7 @@ export declare const listBookings: import("@sveltejs/kit").RemoteQueryFunction<{
         currency: string;
         customer: Record<string, unknown>;
         totals: import("../../db-postgres/schema/booking/index.js").BookingTotals;
+        pricedAt: Date | null;
         accessToken: string;
         staffNotes: string | null;
         language: string | null;
@@ -60,6 +61,7 @@ export declare const getBooking: import("@sveltejs/kit").RemoteQueryFunction<str
         currency: string;
         customer: Record<string, unknown>;
         totals: import("../../db-postgres/schema/booking/index.js").BookingTotals;
+        pricedAt: Date | null;
         accessToken: string;
         staffNotes: string | null;
         language: string | null;
@@ -172,6 +174,7 @@ export declare const editBookingStaff: import("@sveltejs/kit").RemoteCommand<{
     updatedAt: Date;
     customer: Record<string, unknown>;
     totals: import("../../db-postgres/schema/booking/index.js").BookingTotals;
+    pricedAt: Date | null;
     staffNotes: string | null;
     balanceDueAt: Date | null;
     holdExpiresAt: Date | null;

package/dist/admin/remote/booking.remote.js

@@ -196,7 +196,10 @@ export const listBookingCatalog = query(async () => {
 /** Staff: create a booking from the admin panel. @public */
 export const createBookingStaff = command(z.any(), async (input) => {
     requireAuth();
-    return createBooking(input);
+    // `actor: 'staff'` — zalogowana obsługa może podać cenę ręcznie (korekta, rabat
+    // negocjowany telefonicznie). Publiczne ścieżki NIE mają tego prawa: bez tej flagi
+    // rdzeń bierze cenę wyłącznie z katalogu (`resolvePrice`).
+    return createBooking(input, { actor: 'staff' });
 });
 /** Staff: edit a booking's items/customer (full edit power). @public */
 export const editBookingStaff = command(z.object({ bookingId: z.string().uuid(), changes: z.any() }), async ({ bookingId, changes }) => {
@@ -206,7 +209,7 @@ export const editBookingStaff = command(z.object({ bookingId: z.string().uuid(),
 /** Staff: generate an installment/balance payment link for any amount. @public */
 export const addPaymentLink = command(z.object({ bookingId: z.string().uuid(), amount: z.number().int().positive() }), async ({ bookingId, amount }) => {
     requireAuth();
-    const result = await createInstallmentPayment(bookingId, amount);
+    const result = await createInstallmentPayment(bookingId, { actor: 'staff', amount });
     if (result.paymentLink) {
         await sendBookingEmail(bookingId, 'payment-link', {
             amount,

package/dist/booking/client/index.d.ts

@@ -29,10 +29,13 @@ export declare function createBookingClient(opts?: BookingClientOptions): {
     updateParticipant: (token: string, participantId: string, data: Record<string, unknown>) => Promise<unknown>;
     /** Drugi czynnik: weryfikuj numer telefonu; sukces ustawia sesję portalu (cookie). */
     verifyPhone: (token: string, phone: string) => Promise<unknown>;
-    /** Self-service: dołóż wycieczki istniejącym osobom (recompute salda). */
+    /**
+     * Self-service: dołóż wycieczki istniejącym osobom (recompute salda).
+     *
+     * Cena **nie jest** parametrem — ustala ją serwer z katalogu (`resolvePrice`).
+     */
     addTrips: (token: string, additions: Array<{
         tripRef: string;
-        unitPrice: number;
         assignments: string[];
     }>) => Promise<unknown>;
 };

package/dist/booking/client/index.js

@@ -37,7 +37,11 @@ export function createBookingClient(opts = {}) {
         updateParticipant: (token, participantId, data) => req(`/api/booking/portal/${token}?action=participant`, jsonInit('POST', { participantId, data })),
         /** Drugi czynnik: weryfikuj numer telefonu; sukces ustawia sesję portalu (cookie). */
         verifyPhone: (token, phone) => req(`/api/booking/portal/${token}?action=verify-phone`, jsonInit('POST', { phone })),
-        /** Self-service: dołóż wycieczki istniejącym osobom (recompute salda). */
+        /**
+         * Self-service: dołóż wycieczki istniejącym osobom (recompute salda).
+         *
+         * Cena **nie jest** parametrem — ustala ją serwer z katalogu (`resolvePrice`).
+         */
         addTrips: (token, additions) => req(`/api/booking/portal/${token}?action=add-trips`, jsonInit('POST', { additions }))
     };
 }

package/dist/booking/client/use-booking.svelte.d.ts

@@ -19,7 +19,6 @@ export declare function useBooking(token: string, opts?: BookingClientOptions):
     verifyPhone: (phone: string) => Promise<void>;
     addTrips: (additions: Array<{
         tripRef: string;
-        unitPrice: number;
         assignments: string[];
     }>) => Promise<void>;
 };

package/dist/booking/config.d.ts

@@ -50,6 +50,25 @@ export interface BookingConfig {
     surfacedCollections?: string[];
     /** Deposit that secures a reservation, in minor units (default 0). */
     depositAmount?: number;
+    /**
+     * **Szew serwerowy: cena bazowa (dorosłego) pozycji katalogu, w groszach.**
+     *
+     * Rdzeń nie zna kształtu katalogu (`tripRef` jest dla niego nieprzezroczysty), więc
+     * cenę musi podać projekt. Wołany **wyłącznie na serwerze** przy każdej rezerwacji
+     * składanej przez klienta końcowego — dzięki temu przeglądarka nie ma na cenę wpływu.
+     *
+     * **Wymagany, gdy booking wystawia publiczne endpointy** (`createBookingHandler`,
+     * portal). Bez niego rdzeń odmawia wyceny (fail-closed) zamiast zaufać cenie z żądania.
+     * Obsługa w adminie (`actor: 'staff'`) nadal może podać cenę ręcznie — korekta jest
+     * zamierzoną funkcją.
+     *
+     * @example
+     * resolvePrice: async (tripRef) => {
+     *   const entry = await resolveEntry({ id: tripRef, status: 'published' });
+     *   return Math.round(Number(entry?.price ?? 0) * 100); // PLN → grosze
+     * }
+     */
+    resolvePrice?: (tripRef: string) => number | Promise<number>;
     /** Discount rules (legacy per-line engine; booking now prices per-participant). */
     pricing?: PricingConfig;
     /**
@@ -127,6 +146,7 @@ export interface ResolvedBookingConfig {
     catalogCollection: string | null;
     surfacedCollections: string[];
     depositAmount: number;
+    resolvePrice: ((tripRef: string) => number | Promise<number>) | null;
     pricing: PricingConfig;
     participantPricing: (() => ParticipantPricingConfig | Promise<ParticipantPricingConfig>) | null;
     arrivalDateField: string;

package/dist/booking/config.js

@@ -5,6 +5,7 @@ export function resolveBookingConfig(config) {
         catalogCollection: config.catalogCollection ?? null,
         surfacedCollections: config.surfacedCollections ?? [],
         depositAmount: config.depositAmount ?? 0,
+        resolvePrice: config.resolvePrice ?? null,
         pricing: config.pricing ?? { rules: [] },
         participantPricing: config.participantPricing ?? null,
         arrivalDateField: config.arrivalDateField ?? 'arrivalDate',

package/dist/booking/draft.d.ts

@@ -24,8 +24,15 @@ export interface ItemAssignmentInput {
 export interface BookingItemInput {
     tripRef: string;
     departureDate: Date | null;
-    /** Unit (adult) price (minor units) snapshotted at booking time. */
-    unitPrice: number;
+    /**
+     * Cena bazowa (dorosłego) w groszach, zamrażana na pozycji.
+     *
+     * **Honorowana wyłącznie dla `actor: 'staff'`** (ręczna korekta w adminie). Dla klienta
+     * końcowego (`public`/`portal`) jest ignorowana — cenę ustala rdzeń z katalogu przez szew
+     * `resolvePrice`, bo inaczej każdy mógłby zamówić wyprawę za grosz. Pomiń, gdy cena ma
+     * pochodzić z katalogu.
+     */
+    unitPrice?: number;
     /** Who takes this trip (+ their per-trip data). Count derives from this. */
     assignments: ItemAssignmentInput[];
 }
@@ -64,8 +71,20 @@ export interface BookingDraft {
     balanceDueAt: Date | null;
     holdExpiresAt: Date;
 }
+/**
+ * Pozycja po przejściu przez bramkę cenową — cena jest już ustalona (z katalogu, ze
+ * snapshotu albo od obsługi). Typ istnieje po to, by **nie dało się** zbudować rezerwacji
+ * z pozycji, której nikt nie wycenił: kompilator pilnuje, że bramka poszła pierwsza.
+ */
+export type PricedBookingItem = BookingItemInput & {
+    unitPrice: number;
+};
+/** Ładunek create z pozycjami już wycenionymi. */
+export type PricedCreateInput = Omit<CreateBookingInput, 'items'> & {
+    items: PricedBookingItem[];
+};
 /** Build the per-participant pricing inputs from a create payload. */
-export declare function pricingInputsFromCreate(input: CreateBookingInput, identityFields: FieldDef[]): {
+export declare function pricingInputsFromCreate(input: PricedCreateInput, identityFields: FieldDef[]): {
     participants: PricingParticipant[];
     trips: PricedTrip[];
 };
@@ -74,4 +93,4 @@ export declare function pricingInputsFromCreate(input: CreateBookingInput, ident
  * rows/totals to persist. Prices per-participant (age bands + volume ladder +
  * early-bird), anchored to the arrival date in `ctx.anchor`.
  */
-export declare function buildBookingDraft(input: CreateBookingInput, config: ResolvedBookingConfig, ctx: DraftPricingContext, now: Date): BookingDraft;
+export declare function buildBookingDraft(input: PricedCreateInput, config: ResolvedBookingConfig, ctx: DraftPricingContext, now: Date): BookingDraft;

package/dist/booking/payment-amount.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pure amount gate for installment/balance payment links — the payment-side twin
+ * of the 0.37.1 price gate. Keeps the *amount* from being dictated by an untrusted
+ * HTTP request. All amounts are in **minor units** (grosze).
+ */
+export type PaymentActor = 'portal' | 'staff';
+/** Thrown when a requested payment amount is not allowed for the actor. */
+export declare class PaymentAmountError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolve the amount to charge on an installment/balance link.
+ *
+ * - `portal` (untrusted): the server dictates the amount = current outstanding
+ *   `balance`; any `requestedAmount` from the browser is ignored. Fail-closed
+ *   when nothing is due (`balance <= 0`).
+ * - `staff` (trusted): honors `requestedAmount` (positive integer minor units) —
+ *   staff may bill a custom amount, e.g. a partial installment or a prepayment.
+ *
+ * @throws {PaymentAmountError} portal with nothing due, or staff with a
+ *   non-positive / fractional / missing amount.
+ */
+export declare function resolveInstallmentAmount(balance: number, actor: PaymentActor, requestedAmount?: number): number;

package/dist/booking/payment-amount.js

@@ -0,0 +1,37 @@
+/**
+ * Pure amount gate for installment/balance payment links — the payment-side twin
+ * of the 0.37.1 price gate. Keeps the *amount* from being dictated by an untrusted
+ * HTTP request. All amounts are in **minor units** (grosze).
+ */
+/** Thrown when a requested payment amount is not allowed for the actor. */
+export class PaymentAmountError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PaymentAmountError';
+    }
+}
+/**
+ * Resolve the amount to charge on an installment/balance link.
+ *
+ * - `portal` (untrusted): the server dictates the amount = current outstanding
+ *   `balance`; any `requestedAmount` from the browser is ignored. Fail-closed
+ *   when nothing is due (`balance <= 0`).
+ * - `staff` (trusted): honors `requestedAmount` (positive integer minor units) —
+ *   staff may bill a custom amount, e.g. a partial installment or a prepayment.
+ *
+ * @throws {PaymentAmountError} portal with nothing due, or staff with a
+ *   non-positive / fractional / missing amount.
+ */
+export function resolveInstallmentAmount(balance, actor, requestedAmount) {
+    if (actor === 'staff') {
+        if (!Number.isInteger(requestedAmount) || requestedAmount <= 0) {
+            throw new PaymentAmountError('Kwota wpłaty musi być dodatnią liczbą całkowitą (grosze).');
+        }
+        return requestedAmount;
+    }
+    // portal: browser does not dictate the amount — the server charges the balance.
+    if (balance <= 0) {
+        throw new PaymentAmountError('Brak salda do zapłaty.');
+    }
+    return balance;
+}

package/dist/booking/server/adjustments.js

@@ -36,7 +36,9 @@ export async function addBookingAdjustment(bookingId, input, opts) {
         if (!booking)
             throw new Error(`Booking ${bookingId} not found`);
         assertEditAllowed(booking.status);
-        const result = await priceFromExistingRows(tx, bookingId, config, now);
+        // Bez `now`: przeliczenie idzie z zamrożonej daty wyceny rezerwacji. Zaksięgowanie
+        // dopłaty nie może odebrać klientowi early-birda sprzed miesięcy.
+        const result = await priceFromExistingRows(tx, bookingId, config);
         const active = await tx
             .select()
             .from(bookingAdjustmentsTable)
@@ -109,7 +111,8 @@ export async function voidBookingAdjustment(adjustmentId, opts) {
             .update(bookingAdjustmentsTable)
             .set({ voidedAt: now, voidedBy: opts.actor })
             .where(eq(bookingAdjustmentsTable.id, adjustmentId));
-        const result = await priceFromExistingRows(tx, adj.bookingId, config, now);
+        // Wycofanie korekty — również z zamrożonej daty wyceny, nie z dzisiejszej.
+        const result = await priceFromExistingRows(tx, adj.bookingId, config);
         const active = await tx
             .select()
             .from(bookingAdjustmentsTable)

package/dist/booking/server/bookings.d.ts

@@ -3,6 +3,7 @@ import { type CreateBookingInput, type PersonInput, type ItemAssignmentInput } f
 import { type ParticipantPriceResult } from '../participant-pricing.js';
 import type { ResolvedBookingConfig } from '../config.js';
 import { type BookingTx } from './reminders.js';
+import { type PriceActor } from './price-source.js';
 /** Edit payload: replace people + items (+assignments) and/or customer details. */
 export interface BookingEditChanges {
     persons?: PersonInput[];
@@ -22,6 +23,7 @@ export interface BookingEditChanges {
  */
 export declare function createBooking(input: CreateBookingInput, opts?: {
     now?: Date;
+    actor?: PriceActor;
 }): Promise<{
     booking: typeof bookingsTable.$inferSelect;
     accessToken: string;
@@ -41,5 +43,9 @@ export declare function editBooking(bookingId: string, changes: BookingEditChang
  * edit). Shared by adjustment recompute — mirrors the "no items change" branch
  * of {@link editBooking}. Must run inside a transaction that has locked the
  * booking row.
+ *
+ * **Wycenia na zamrożoną datę rezerwacji (`pricedAt`), nie na dziś.** To jest ścieżka
+ * korekt: obsługa księguje dopłatę ustaloną telefonicznie, a przeliczenie nie może przy
+ * okazji odebrać klientowi rabatu za wczesną rezerwację.
  */
-export declare function priceFromExistingRows(tx: BookingTx, bookingId: string, config: ResolvedBookingConfig, now: Date): Promise<ParticipantPriceResult>;
+export declare function priceFromExistingRows(tx: BookingTx, bookingId: string, config: ResolvedBookingConfig): Promise<ParticipantPriceResult>;