includio-cms 0.36.2 → 0.36.4

package/API.md

@@ -1,4 +1,4 @@
-# includio-cms — Public API v0.36.2
+# includio-cms — Public API v0.36.4
 
 > Auto-generated by `scripts/generate-api-md.ts`. Do not edit by hand.
 

package/CHANGELOG.md

@@ -3,6 +3,24 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.36.4 — 2026-06-11
+
+Lista wpisów kolekcji — fix: URL pod nazwą wpisu (oraz wyszukiwarka i ostrzeżenia a11y) znikał, gdy początkowy draft v1 różnił się od późniejszej opublikowanej treści (np. slug ustawiony dopiero po publikacji). Ujednolicono precedencję wyboru wersji w jednym helperze (published-first), spójnie z resztą admina.
+
+### Fixed
+- `getVersionData` w liście kolekcji (`collection-entries.svelte`) preferowało draft przed published. `draftVersions[lang]` to najnowsza wersja z `publishedAt == null` — co może być przestarzałym początkowym draftem (v1), starszym niż najnowsza publikacja, gdy późniejsze edycje szły tylko przez publikację. Efekt: subtytuł URL czytał pusty/nieaktualny slug z v1 i znikał, mimo że opublikowana wersja miała slug. Naprawione przez nowy SSOT `getRawEntryVersionData(entry, language)` z precedencją published-first (requested lang published → draft, potem any lang published → draft) — spójną z `getRawCollectionEntryLabelWithLanguage`, custom columns i edytorem wpisu.
+- Ten sam helper zasila też tekst wyszukiwarki (`getSearchText`) i ostrzeżenia a11y (`countA11yWarnings`) — wcześniej również czytały przestarzały draft. `columnData` uproszczone (redundantny published-first override usunięty).
+- `extractEntryUrl` przekazuje teraz `language` do `resolveEntryUrl` — bez efektu dla płaskiego slug, ale poprawne dla projektów wielojęzycznych ze zlokalizowanym slugiem. Dodany regression test (`entryVersionData.spec.ts`) odtwarzający scenariusz pustego draftu v1 + opublikowanego sluga.
+
+## 0.36.3 — 2026-06-11
+
+Relacje opcjonalne — fix: niewybrana relacja (pole bez `required`) blokowała zapis wpisu („Invalid input: expected string, received null") albo wywalała populację przy pustym stringu. Teraz „brak wyboru" działa w obie strony — Zod akceptuje null/""/undefined, a populacja pomija puste wartości.
+
+### Fixed
+- Schemat Zod relacji niewymaganej (`generateZodSchemaFromField`) akceptuje teraz `null` obok `""`/`undefined` (`z.string().nullish().default("")`). Wcześniej `null` (znormalizowane dane lub wyczyszczenie pola w adminie) rzucał „Invalid input: expected string, received null" i blokował zapis wpisu. Bez nowej walidacji uuid — dowolny string nadal przechodzi, więc zero regresji dla istniejących danych.
+- `resolveRelationFields` pomija puste stringi przy zbieraniu ID do populacji (relacje pojedyncze i multiple). Pusty string nie trafia już do zapytania `WHERE id IN ('')`, które Postgres odrzucał jako nieprawidłowy uuid (`invalid input syntax for type uuid: ""`).
+- Efekt łączny: opcjonalna relacja bez wyboru działa w obie strony — zapis w adminie (Zod akceptuje null/"") oraz odczyt na froncie (populacja pomija puste). Dodany regression test dla akceptacji null/""/undefined.
+
 ## 0.36.2 — 2026-06-08
 
 Per-status overrides (`ShopConfig.orderStatuses`) + globalny rejestr subject placeholders (`formatSubject`/`ShopConfig.emailSubjectPlaceholders`) + nowy hook `ShopConfig.resolveStatusSubject` do czytania subject z CMS + Handlebars helper `{{{structured}}}` renderujący `StructuredContentDoc` (TipTap) jako email-safe HTML z automatycznym token replacement. Email context rozszerzony o billing fields (firma/NIP/adres/telefon). Dwa fixy bugów w resolverze CMS singletons w mailach. Zaprojektowane pod sklepy ze szkoleniami/wydarzeniami (stationary), gdzie statusy `preparing`/`sent` nie mają sensu. Wszystkie API generyczne, do reusu w innych consumer projects.

package/DOCS.md

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

package/ROADMAP.md

@@ -57,6 +57,7 @@
 ## Backlog
 
 - [ ] `[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 -->
+- [ ] `[feature]` `[P2]` `<Video>` — eksponować ref wewnętrznego `<video>` (np. bindable `element` prop lub forward `bind:this`). Obecnie konsument potrzebujący programowej kontroli (play/pause, scrub, mute toggle) musi owijać w `<div bind:this>` + `querySelector('video')` — boilerplate i kruche. Zgłoszone przy customowym hero-wideo (autoplay + przycisk pauzy). <!-- files: src/lib/sveltekit/components/video.svelte -->
 - [ ] `[feature]` `[P1]` Re-introduce entry autosave with strict draft-only guard (opt-in via `cms.config.ts`, never touch published versions, debounced + visual countdown). Removed in 0.26.0 / S8 because old impl could touch published data ambiguously.
 - [ ] `[feature]` `[P2]` Migrate `shipping-method-form` na sveltekit-superforms + formsnap (S8 zostawił hand-rolled validation + FormErrorSummary; pełna migracja wymaga schema dla multi-lang record + dynamic carrier config + price net/gross toggle).
 - [ ] `[feature]` `[P2]` Storybook story dla `entry-page` (Default/Saving/Saved/Error/Draft/WithErrors/Confirmation) — wymaga mock context: `setRemotes` (5 commands), `setBreadcrumbs`, `setContentLanguage`, RawEntry/DbEntryVersion fixtures. S8 odłożone do S10 a11y sweep.

package/dist/admin/client/collection/collection-entries.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
 	import { getCollectionEntryDisplayLabel } from '../../utils/entryLabel.js';
+	import { getRawEntryVersionData } from '../../utils/entryVersionData.js';
 	import { getEntryThumbnail, type MediaThumbnailLookup } from '../../utils/entryThumbnail.js';
 	import { arrayMove } from '../../utils/arrayMove.js';
 	import { getRemotes } from '../../../sveltekit/index.js';
@@ -426,15 +427,7 @@
 	}
 
 	function getVersionData(entry: RawEntry): Record<string, unknown> | undefined {
-		const lang = interfaceLanguage.current;
-		const draft = entry.draftVersions[lang];
-		const published = entry.publishedVersions[lang];
-		if (draft?.data) return draft.data as Record<string, unknown>;
-		if (published?.data) return published.data as Record<string, unknown>;
-		// Fallback: any lang
-		for (const v of Object.values(entry.draftVersions)) if (v?.data) return v.data as Record<string, unknown>;
-		for (const v of Object.values(entry.publishedVersions)) if (v?.data) return v.data as Record<string, unknown>;
-		return undefined;
+		return getRawEntryVersionData(entry, interfaceLanguage.current);
 	}
 
 	function getSearchText(entry: RawEntry): string {
@@ -467,7 +460,8 @@
 		return resolveEntryUrl({
 			slugField: collection.slugField,
 			pathTemplate: collection.pathTemplate,
-			data: data as Record<string, unknown>
+			data: data as Record<string, unknown>,
+			language: interfaceLanguage.current
 		});
 	}
 
@@ -560,9 +554,9 @@
 
 	function mapEntryToRow(entry: RawEntry, lookup: Record<string, string> = {}, mediaThumbs: MediaThumbnailLookup = {}): CollectionDataTableRow {
 		const data = getVersionData(entry) || {};
-		// For custom columns, prefer published data (complete) over draft (may be partial)
-		const lang = interfaceLanguage.current;
-		const columnData = entry.publishedVersions[lang]?.data || entry.draftVersions[lang]?.data || data;
+		// getVersionData is already published-first (see getRawEntryVersionData),
+		// so it doubles as the source for custom columns.
+		const columnData = data;
 		const customData: Record<string, unknown> = {};
 		if (collection.listColumns) {
 			for (const fieldSlug of collection.listColumns) {

package/dist/admin/utils/entryVersionData.d.ts

@@ -0,0 +1,17 @@
+import type { RawEntry } from '../../types/entries.js';
+/**
+ * Effective entry data for the admin collection list.
+ *
+ * Resolves the version whose data the list should display for a raw entry,
+ * with **published-first** precedence: requested language published → draft,
+ * then any other language published → draft. Returns `undefined` only when the
+ * entry has no usable version data at all.
+ *
+ * Why published-first: `draftVersions[lang]` is the latest version with
+ * `publishedAt == null`, which can be an *older* lingering draft (e.g. the
+ * initial v1) when later edits were published without re-saving a draft. The
+ * rest of the admin (entry label, custom columns, entry editor) already prefers
+ * published — this keeps the URL subtitle, search text and a11y warnings
+ * consistent with it. Mirrors {@link getRawCollectionEntryLabelWithLanguage}.
+ */
+export declare function getRawEntryVersionData(entry: RawEntry, language: string): Record<string, unknown> | undefined;

package/dist/admin/utils/entryVersionData.js

@@ -0,0 +1,29 @@
+/**
+ * Effective entry data for the admin collection list.
+ *
+ * Resolves the version whose data the list should display for a raw entry,
+ * with **published-first** precedence: requested language published → draft,
+ * then any other language published → draft. Returns `undefined` only when the
+ * entry has no usable version data at all.
+ *
+ * Why published-first: `draftVersions[lang]` is the latest version with
+ * `publishedAt == null`, which can be an *older* lingering draft (e.g. the
+ * initial v1) when later edits were published without re-saving a draft. The
+ * rest of the admin (entry label, custom columns, entry editor) already prefers
+ * published — this keeps the URL subtitle, search text and a11y warnings
+ * consistent with it. Mirrors {@link getRawCollectionEntryLabelWithLanguage}.
+ */
+export function getRawEntryVersionData(entry, language) {
+    for (const bucket of [entry.publishedVersions, entry.draftVersions]) {
+        const data = bucket?.[language]?.data;
+        if (data)
+            return data;
+    }
+    for (const bucket of [entry.publishedVersions, entry.draftVersions]) {
+        for (const version of Object.values(bucket ?? {})) {
+            if (version?.data)
+                return version.data;
+        }
+    }
+    return undefined;
+}

package/dist/core/fields/fieldSchemaToTs.js

@@ -214,7 +214,11 @@ export function generateZodSchemaFromField(field, languages, options = {
             if (field.required) {
                 return z.string().uuid({ message: msg.required });
             }
-            return z.string().optional().default('');
+            // Non-required: a relation id, or "no selection". The admin (and legacy
+            // data) may send '', null or undefined for an unset relation — accept
+            // all of them (`.nullish()` adds null + undefined) so an empty optional
+            // relation never blocks save. Empty values are skipped at populate time.
+            return z.string().nullish().default('');
         }
         case 'object': {
             // Children's `required` is enforced when the object itself is required OR

package/dist/core/server/fields/resolveRelationFields.js

@@ -30,13 +30,15 @@ export async function resolveRelationFields(data, fields, ctx) {
             }
             switch (field.type) {
                 case 'relation': {
+                    // Skip empty strings — an unset optional relation stores '' and must
+                    // never reach the id query (Postgres rejects '' as uuid).
                     if (field.multiple && Array.isArray(val)) {
                         for (const id of val) {
-                            if (typeof id === 'string')
+                            if (typeof id === 'string' && id !== '')
                                 entriesIds.push(id);
                         }
                     }
-                    else if (typeof val === 'string') {
+                    else if (typeof val === 'string' && val !== '') {
                         entriesIds.push(val);
                     }
                     break;

package/dist/updates/0.36.3/index.d.ts

@@ -0,0 +1,2 @@
+import type { CmsUpdate } from '../index.js';
+export declare const update: CmsUpdate;

package/dist/updates/0.36.3/index.js

@@ -0,0 +1,12 @@
+export const update = {
+    version: '0.36.3',
+    date: '2026-06-11',
+    description: 'Relacje opcjonalne — fix: niewybrana relacja (pole bez `required`) blokowała zapis wpisu („Invalid input: expected string, received null") albo wywalała populację przy pustym stringu. Teraz „brak wyboru" działa w obie strony — Zod akceptuje null/""/undefined, a populacja pomija puste wartości.',
+    features: [],
+    fixes: [
+        'Schemat Zod relacji niewymaganej (`generateZodSchemaFromField`) akceptuje teraz `null` obok `""`/`undefined` (`z.string().nullish().default("")`). Wcześniej `null` (znormalizowane dane lub wyczyszczenie pola w adminie) rzucał „Invalid input: expected string, received null" i blokował zapis wpisu. Bez nowej walidacji uuid — dowolny string nadal przechodzi, więc zero regresji dla istniejących danych.',
+        '`resolveRelationFields` pomija puste stringi przy zbieraniu ID do populacji (relacje pojedyncze i multiple). Pusty string nie trafia już do zapytania `WHERE id IN (\'\')`, które Postgres odrzucał jako nieprawidłowy uuid (`invalid input syntax for type uuid: ""`).',
+        'Efekt łączny: opcjonalna relacja bez wyboru działa w obie strony — zapis w adminie (Zod akceptuje null/"") oraz odczyt na froncie (populacja pomija puste). Dodany regression test dla akceptacji null/""/undefined.'
+    ],
+    breakingChanges: []
+};

package/dist/updates/0.36.4/index.d.ts

@@ -0,0 +1,2 @@
+import type { CmsUpdate } from '../index.js';
+export declare const update: CmsUpdate;

package/dist/updates/0.36.4/index.js

@@ -0,0 +1,12 @@
+export const update = {
+    version: '0.36.4',
+    date: '2026-06-11',
+    description: 'Lista wpisów kolekcji — fix: URL pod nazwą wpisu (oraz wyszukiwarka i ostrzeżenia a11y) znikał, gdy początkowy draft v1 różnił się od późniejszej opublikowanej treści (np. slug ustawiony dopiero po publikacji). Ujednolicono precedencję wyboru wersji w jednym helperze (published-first), spójnie z resztą admina.',
+    features: [],
+    fixes: [
+        '`getVersionData` w liście kolekcji (`collection-entries.svelte`) preferowało draft przed published. `draftVersions[lang]` to najnowsza wersja z `publishedAt == null` — co może być przestarzałym początkowym draftem (v1), starszym niż najnowsza publikacja, gdy późniejsze edycje szły tylko przez publikację. Efekt: subtytuł URL czytał pusty/nieaktualny slug z v1 i znikał, mimo że opublikowana wersja miała slug. Naprawione przez nowy SSOT `getRawEntryVersionData(entry, language)` z precedencją published-first (requested lang published → draft, potem any lang published → draft) — spójną z `getRawCollectionEntryLabelWithLanguage`, custom columns i edytorem wpisu.',
+        'Ten sam helper zasila też tekst wyszukiwarki (`getSearchText`) i ostrzeżenia a11y (`countA11yWarnings`) — wcześniej również czytały przestarzały draft. `columnData` uproszczone (redundantny published-first override usunięty).',
+        '`extractEntryUrl` przekazuje teraz `language` do `resolveEntryUrl` — bez efektu dla płaskiego slug, ale poprawne dla projektów wielojęzycznych ze zlokalizowanym slugiem. Dodany regression test (`entryVersionData.spec.ts`) odtwarzający scenariusz pustego draftu v1 + opublikowanego sluga.'
+    ],
+    breakingChanges: []
+};

package/dist/updates/index.js

@@ -69,6 +69,8 @@ import { update as update0350 } from './0.35.0/index.js';
 import { update as update0360 } from './0.36.0/index.js';
 import { update as update0361 } from './0.36.1/index.js';
 import { update as update0362 } from './0.36.2/index.js';
+import { update as update0363 } from './0.36.3/index.js';
+import { update as update0364 } from './0.36.4/index.js';
 export const updates = [
     update0065,
     update0066,
@@ -140,7 +142,9 @@ export const updates = [
     update0350,
     update0360,
     update0361,
-    update0362
+    update0362,
+    update0363,
+    update0364
 ];
 export const getUpdatesFrom = (fromVersion) => {
     const fromParts = fromVersion.split('.').map(Number);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "includio-cms",
-	"version": "0.36.2",
+	"version": "0.36.4",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",