includio-cms 0.36.2 → 0.36.3

package/API.md

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

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 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.3)
 
 > 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/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/index.js

@@ -69,6 +69,7 @@ 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';
 export const updates = [
     update0065,
     update0066,
@@ -140,7 +141,8 @@ export const updates = [
     update0350,
     update0360,
     update0361,
-    update0362
+    update0362,
+    update0363
 ];
 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.3",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",