includio-cms 0.16.0 → 0.18.0

package/dist/updates/0.17.0/index.js

@@ -0,0 +1,78 @@
+export const update = {
+    version: '0.17.0',
+    date: '2026-04-29',
+    description: 'Konsolidacja entry resolverów — kanoniczny `resolveEntry()` / `resolveEntries()` / `countEntries()` w jednym public API. Locale strict, cycle detection, populate config per-field opt-out + maxDepth. Hard remove starych funkcji (getEntry, getEntries, getRawEntry/ies, getDbEntry/ies, populateEntryData) z public surface — przeniesione do internal lub całkowicie usunięte.',
+    features: [
+        '`resolveEntry({ id?, collection?, locale?, status?, populate? })` — kanoniczny resolver pojedynczego entry; `id` lub `collection` wymagane. Default locale = `cms.languages[0]`, default status = `published`. Zwraca null gdy locale/status nie ma versionu (strict, brak fallback).',
+        '`resolveEntries({ collection, locale?, status?, ids?, filter?, orderBy?, limit?, offset?, populate? })` — kanoniczny lister; pokrywa wszystkie use case starego `getEntries`.',
+        '`countEntries({ collection, locale?, status?, ids?, filter? })` — zlicza entries pasujące do kryteriów (per locale, per status). Bez populate (tani DB count).',
+        '`PopulateConfig` — typ public: `{ maxDepth?: number; fields?: Record<string, false> }`. Per-field opt-out (`{ author: false }` → raw ID). Default maxDepth = 5 (soft cap).',
+        'Cycle detection w nested populate — A → B → A nie wybucha; powtórzony entryId zachowuje raw ID zamiast dalszej rekurencji.',
+        'Status cascade — draft entry z `status: "draft"` populuje draft relations (jeśli istnieją w tym samym locale). Published cascade do published nested.',
+        '`status: "scheduled"` — dostępne w resolverze. Use case: strona z odliczaniem (countdown) do launchu produktu/postu. `entry._publishedAt` daje datę przyszłej publikacji.'
+    ],
+    fixes: [
+        'Locale spójny w całym call chain — żaden field-level resolver nie hardcoduje już lokalizacji ani nie używa innego defaultu niż top-level resolver. Stara fragmentacja (`resolveRelationFields` defaultowało do `getEntries` published-only) usunięta.',
+        'Recursion guard — głęboka kolekcja relacji (≥ 6 poziomów) nie wybucha już stackiem. Soft maxDepth=5 + cycle detection.',
+        'Strict locale — brak ukrytego fallbacku do `cms.languages[0]` w nested resolverach (był różnie w każdym field-resolverze).'
+    ],
+    breakingChanges: [
+        '**REMOVED z public API**: `getEntry`, `getEntries`, `getEntryOrThrow`, `getRawEntry`, `getRawEntries`, `getRawEntryOrThrow`, `getDbEntry`, `getDbEntries`, `populateEntryData`. Wszystkie te funkcje były dotąd re-exportowane przez `includio-cms/server` i `includio-cms`. **Zamień na `resolveEntry`/`resolveEntries`/`countEntries`** zgodnie z migration table niżej. Nie ma deprecated wrappera — hard remove zgodnie z polityką lean-v1 (wszystkie breakingy PRZED v1.0).',
+        '**Rename arg `language` → `locale`** w `resolveEntry`/`resolveEntries`/`countEntries`. Stare API używało `language`, nowe `locale` (semantycznie bardziej precyzyjne; wartość bez zmian — `cms.languages[N]`).',
+        '**Rename arg `slug` → `collection`** w resolverach. Stare API używało `slug` (co konfundowało z slugiem entry). Nowe: `collection: "posts"`. Singletons też używają `collection: "settings"` (cms.getBySlug obejmuje obie typy).',
+        '**`status` enum zwężony** z `"published" | "draft" | "scheduled" | "archived"` do `"published" | "draft" | "scheduled"`. `archived` nie jest już dostępny w resolverze (to filter listy, nie fetch by id) — admin używa internal `_getRawEntries` envelope.',
+        '**Plugin `populateResolver` 3-arg signature** — custom field plugin `populateResolver(value, field)` ma teraz 3-ci arg `ctx: PopulateCtx` (locale, status, depth, visited, populate, entryId). Plugin API jest `@experimental`, więc breaking dopuszczalne. Migracja: zaktualizuj sygnaturę. Stary 2-arg call zostaje wywołany ale ignoruje cascade — najlepiej dodać 3-ci arg.',
+        '**`PopulateConfig`** wymagany dla opt-out — wcześniej populate był all-or-nothing.',
+        '**`populatePreviewData` (admin remote)** używa teraz internal `_populate` zamiast `populateEntryData`. Public API niezmienione, ale jeśli importowałeś `populateEntryData` jako helper — usuń.',
+        '**Internal renames** — `_getRawEntry/ies`, `_getDbEntry/ies`, `_getRawEntryOrThrow`. Funkcje pozostają dostępne dla admin REST i remote, ale **NIE** są re-exportowane przez `includio-cms/server`. Userland code MUSI przejść na `resolveEntry`/`resolveEntries`.'
+    ],
+    notes: `Migration table:
+
+| Old | New |
+|---|---|
+| \`getEntry({ slug, id, language, status })\` | \`resolveEntry({ collection: slug, id, locale: language, status })\` |
+| \`getEntry({ slug, language })\` (singleton) | \`resolveEntry({ collection: slug, locale: language })\` |
+| \`getEntries({ slug, language, status, ids?, limit?, offset? })\` | \`resolveEntries({ collection: slug, locale: language, status, ids?, limit?, offset? })\` |
+| \`getEntryOrThrow(opts)\` | \`const e = await resolveEntry(opts); if (!e) throw new Error('Entry not found');\` |
+| \`getRawEntry/ies(...)\` | INTERNAL — niedostępne. Jeśli potrzebujesz envelope z per-language draft/published versions, zbuduj custom REST endpoint po stronie aplikacji. |
+| \`getDbEntry/ies(...)\` | INTERNAL — niedostępne. Userland NIE powinien używać raw DB queries; przejdź na \`resolveEntry/ies\`. |
+| \`populateEntryData(data, fields, language, entryId?)\` | INTERNAL — admin preview używa wewnątrz. |
+
+Before/after:
+
+\`\`\`ts
+// PRZED (0.16):
+import { getEntry, getEntries } from 'includio-cms/server';
+const post = await getEntry({ slug: 'posts', id: postId, language: 'pl' });
+const all = await getEntries({ slug: 'posts', language: 'pl', limit: 10 });
+
+// PO (0.17):
+import { resolveEntry, resolveEntries } from 'includio-cms/server';
+const post = await resolveEntry({ collection: 'posts', id: postId, locale: 'pl' });
+const all = await resolveEntries({ collection: 'posts', locale: 'pl', limit: 10 });
+\`\`\`
+
+Populate opt-out:
+
+\`\`\`ts
+// Pomiń populate dla pojedynczego pola (zwróć raw ID zamiast Entry):
+const post = await resolveEntry({
+  collection: 'posts',
+  id: postId,
+  locale: 'pl',
+  populate: { fields: { author: false } }
+});
+console.log(post.author); // 'a1' (string, nie Entry)
+
+// Ogranicz głębokość rekursji:
+const post = await resolveEntry({
+  collection: 'posts',
+  id: postId,
+  locale: 'pl',
+  populate: { maxDepth: 1 }
+});
+// post.author = pełen Entry, post.author.featuredPost = raw ID (depth 2)
+\`\`\`
+
+Brak SQL migration. Stary code używający usuniętych funkcji rzuci ImportError przy \`pnpm i && pnpm build\` — wszystko w userland kodzie wyłapie się TS-em od razu.`
+};

package/dist/updates/index.js

@@ -51,7 +51,8 @@ import { update as update0153 } from './0.15.3/index.js';
 import { update as update0154 } from './0.15.4/index.js';
 import { update as update0155 } from './0.15.5/index.js';
 import { update as update0160 } from './0.16.0/index.js';
-export const updates = [update0065, update0066, update0067, update0068, update0069, update010, update011, update012, update013, update014, update015, update020, update022, update050, update051, update052, update053, update054, update055, update056, update057, update058, update060, update061, update062, update070, update071, update072, update073, update080, update090, update0100, update0110, update0120, update0130, update0131, update0132, update0133, update0134, update0140, update0141, update0142, update0143, update0144, update0145, update0146, update0150, update0151, update0152, update0153, update0154, update0155, update0160];
+import { update as update0170 } from './0.17.0/index.js';
+export const updates = [update0065, update0066, update0067, update0068, update0069, update010, update011, update012, update013, update014, update015, update020, update022, update050, update051, update052, update053, update054, update055, update056, update057, update058, update060, update061, update062, update070, update071, update072, update073, update080, update090, update0100, update0110, update0120, update0130, update0131, update0132, update0133, update0134, update0140, update0141, update0142, update0143, update0144, update0145, update0146, update0150, update0151, update0152, update0153, update0154, update0155, update0160, update0170];
 export const getUpdatesFrom = (fromVersion) => {
     const fromParts = fromVersion.split('.').map(Number);
     return updates.filter((update) => {

package/package.json

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