includio-cms 0.16.0 → 0.19.0

package/dist/updates/0.18.0/index.js

@@ -0,0 +1,78 @@
+export const update = {
+    version: '0.18.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/0.19.0/index.d.ts

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

package/dist/updates/0.19.0/index.js

@@ -0,0 +1,40 @@
+export const update = {
+    version: '0.19.0',
+    date: '2026-04-29',
+    description: 'Adapter contracts final + 3rd-party SDKs (`@anthropic-ai/sdk`, `openai`, `nodemailer`) przeniesione do `peerDependenciesMeta` jako optional. Adapter typy + factory oznaczone `@public` JSDoc. README sekcja "Writing your own adapter".',
+    features: [
+        'Adapter typy (`DatabaseAdapter`, `FilesAdapter`, `EmailAdapter`, `AIAdapter`) finalne, oznaczone `@public` JSDoc — stabilna powierzchnia kontraktu, TypeScript egzekwuje surface.',
+        'Factory funkcje adapterów (`pg`, `local`, `nodemailerAdapter`, `openAIAdapter`, `claudeAdapter`) oznaczone `@public`.',
+        'README sekcja "Writing your own adapter" + przykład bazujący na `db-postgres` + tabela optional peer dependencies.',
+        'Lazy import 3 SDK (`@anthropic-ai/sdk`, `openai`, `nodemailer`) w factory adapterach — SDK nie ładuje się dopóki adapter nie jest faktycznie użyty.'
+    ],
+    fixes: [
+        'Bundle slim — instalacja `includio-cms` w czystym projekcie nie ciąga już ~7-9MB SDK (anthropic + openai + nodemailer). Zostają w peer optional, doinstalowane tylko gdy faktycznie potrzebne.'
+    ],
+    breakingChanges: [
+        '**`@anthropic-ai/sdk`, `openai`, `nodemailer` przeniesione z `dependencies` do `peerDependenciesMeta` jako optional**. Userland używający `email-nodemailer`/`ai-openai`/`ai-claude` musi sam doinstalować odpowiedni SDK: `pnpm add nodemailer`, `pnpm add openai`, `pnpm add @anthropic-ai/sdk`. Brak peer = throw przy pierwszym użyciu adaptera (`generateAltText`/`sendMail`) z czytelnym komunikatem co doinstalować.',
+        '**`runed` przeniesione z `peerDependenciesMeta.optional` do required peer**. `runed` jest hard-importowane w admin UI (PersistedState), więc opcjonalność była fikcyjna — userland uruchamiający admin BEZ `runed` dostawał crash przy bootcie. Teraz peer wymaga jawnej instalacji (lub pozostaje pulled przez SvelteKit projektu).'
+    ],
+    notes: `Migracja:
+
+1. Dodaj wymagane peer SDK do swojego \`package.json\`:
+
+\`\`\`bash
+# Jeśli używasz nodemailerAdapter:
+pnpm add nodemailer
+
+# Jeśli używasz openAIAdapter:
+pnpm add openai
+
+# Jeśli używasz claudeAdapter:
+pnpm add @anthropic-ai/sdk
+\`\`\`
+
+2. \`runed\` był już peer wcześniej, ale teraz nie jest optional — upewnij się że jest zainstalowane (zwykle pulled przez SvelteKit). Jeśli \`pnpm install\` zgłasza missing peer, dodaj jawnie: \`pnpm add runed\`.
+
+Brak SQL migration. Zmiana czysto package-level.
+
+Pisanie własnych adapterów:
+
+Wszystkie 4 typy adapterów (\`DatabaseAdapter\`, \`FilesAdapter\`, \`EmailAdapter\`, \`AIAdapter\`) mają teraz \`@public\` kontrakty. Patrz README sekcja "Writing your own adapter" + przykład bazujący na \`db-postgres\`.`
+};

package/dist/updates/index.js

@@ -51,7 +51,9 @@ 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 update0180 } from './0.18.0/index.js';
+import { update as update0190 } from './0.19.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, update0180, update0190];
 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.19.0",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",
@@ -177,6 +177,7 @@
 		}
 	},
 	"peerDependencies": {
+		"@anthropic-ai/sdk": ">=0.39.0",
 		"@sveltejs/kit": "^2.48.0",
 		"@sveltejs/vite-plugin-svelte": "^6.2.1",
 		"better-auth": "^1.3.34",
@@ -184,6 +185,8 @@
 		"drizzle-orm": "^0.40.0",
 		"embla-carousel-svelte": "^8.6.0",
 		"formsnap": "^2.0.1",
+		"nodemailer": ">=7.0.0",
+		"openai": ">=6.0.0",
 		"paneforge": "^1.0.2",
 		"postgres": "^3.4.5",
 		"runed": "^0.35.1",
@@ -198,7 +201,13 @@
 		"zod": "^4.0.0"
 	},
 	"peerDependenciesMeta": {
-		"runed": {
+		"@anthropic-ai/sdk": {
+			"optional": true
+		},
+		"nodemailer": {
+			"optional": true
+		},
+		"openai": {
 			"optional": true
 		},
 		"svelte-tiptap": {
@@ -215,6 +224,7 @@
 		}
 	},
 	"devDependencies": {
+		"@anthropic-ai/sdk": "^0.39.0",
 		"@chromatic-com/storybook": "^5.0.1",
 		"@eslint/compat": "^1.2.5",
 		"@eslint/js": "^9.18.0",
@@ -237,6 +247,8 @@
 		"@types/fluent-ffmpeg": "^2.1.27",
 		"@types/node": "^22",
 		"@types/nodemailer": "^7.0.4",
+		"nodemailer": "^7.0.11",
+		"openai": "^6.9.0",
 		"better-auth": "^1.3.34",
 		"bits-ui": "^2.11.5",
 		"clsx": "^2.1.1",
@@ -283,7 +295,6 @@
 		"svelte"
 	],
 	"dependencies": {
-		"@anthropic-ai/sdk": "^0.39.0",
 		"@inlang/paraglide-js": "^2.0.0",
 		"@internationalized/date": "^3.8.2",
 		"@lucide/svelte": "^0.544.0",
@@ -316,8 +327,6 @@
 		"isomorphic-dompurify": "3.0.0-rc.2",
 		"lowlight": "^3.3.0",
 		"mrmime": "^2.0.1",
-		"nodemailer": "^7.0.11",
-		"openai": "^6.9.0",
 		"path-to-regexp": "^8.2.0",
 		"readline": "^1.3.0",
 		"slugify": "^1.6.6",

package/dist/paraglide/messages/en.d.ts

@@ -1,5 +0,0 @@
-export const hello_world: (inputs: {
-    name: NonNullable<unknown>;
-}) => string;
-export const login_hello: (inputs: {}) => string;
-export const login_please_login: (inputs: {}) => string;

package/dist/paraglide/messages/en.js

@@ -1,14 +0,0 @@
-/* eslint-disable */
-
-
-export const hello_world = /** @type {(inputs: { name: NonNullable<unknown> }) => string} */ (i) => {
-	return `Hello, ${i.name} from en!`
-};
-
-export const login_hello = /** @type {(inputs: {}) => string} */ () => {
-	return `Welcome back`
-};
-
-export const login_please_login = /** @type {(inputs: {}) => string} */ () => {
-	return `Login to your account`
-};

package/dist/paraglide/messages/pl.d.ts

@@ -1,5 +0,0 @@
-export const hello_world: (inputs: {
-    name: NonNullable<unknown>;
-}) => string;
-export const login_hello: (inputs: {}) => string;
-export const login_please_login: (inputs: {}) => string;

package/dist/paraglide/messages/pl.js

@@ -1,14 +0,0 @@
-/* eslint-disable */
-
-
-export const hello_world = /** @type {(inputs: { name: NonNullable<unknown> }) => string} */ (i) => {
-	return `Hello, ${i.name} from pl!`
-};
-
-export const login_hello = /** @type {(inputs: {}) => string} */ () => {
-	return `Witaj ponownie`
-};
-
-export const login_please_login = /** @type {(inputs: {}) => string} */ () => {
-	return `Zaloguj się na swoje konto`
-};