includio-cms 0.16.0 → 0.19.0

package/CHANGELOG.md

@@ -3,6 +3,128 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.19.0 — 2026-04-29
+
+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".
+
+### Added
+- 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.
+
+### Fixed
+- 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.
+
+### Breaking
+- **`@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`.
+
+## 0.18.0 — 2026-04-29
+
+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.
+
+### Added
+- `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.
+
+### Fixed
+- 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).
+
+### Breaking
+- **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.
+
 ## 0.16.0 — 2026-04-29
 
 Hard reset martwego kodu — start drogi do v1.0.0. Wycięte: prototyp inline-edit, demo seed, demo routes. Zostają: cmp/ (backend działa), mockups/ (designy), isomorphic-dompurify (Faza 5), tippy.js (slash-command).

package/DOCS.md

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

package/README.md

@@ -38,6 +38,68 @@ export default defineConfig({
 
 See the [full documentation](/docs) for installation, configuration, and usage.
 
+## Writing your own adapter
+
+`includio-cms` ships with default adapters (`db-postgres`, `files-local`, `email-nodemailer`, `ai-openai`, `ai-claude`). Each is a factory returning an object that implements a `@public` contract from `includio-cms/types`. Build your own by implementing the same interface — TypeScript will enforce the surface.
+
+Four adapter contracts:
+
+- `DatabaseAdapter` — entries, versions, media, tags, form submissions, consent logs.
+- `FilesAdapter` — file upload/download/list, optional private files (e.g. shop receipts).
+- `EmailAdapter` — `sendMail`, default from address/name.
+- `AIAdapter` — currently `generateAltText(fileId)`.
+
+Source of truth: [`src/lib/types/adapters/`](src/lib/types/adapters/).
+
+### Minimal custom DB adapter (sketch)
+
+```ts
+import type { DatabaseAdapter } from 'includio-cms/types';
+
+export function myDbAdapter(config: { connection: string }): DatabaseAdapter {
+  // ...connect, prepare your client...
+  return {
+    createEntry: async (data) => { /* ... */ },
+    getEntries: async (opts) => { /* ... */ },
+    countEntries: async (opts) => { /* ... */ },
+    updateEntry: async (data) => { /* ... */ },
+    archiveEntry: async (data) => { /* ... */ },
+    deleteEntry: async (data) => { /* ... */ },
+    createEntryVersion: async (data) => { /* ... */ },
+    updateEntryVersion: async (data) => { /* ... */ },
+    getEntryVersions: async (data) => { /* ... */ },
+    deleteEntryVersion: async (data) => { /* ... */ },
+    // ...form submissions, media files, image/video styles, tags, consent logs...
+  };
+}
+```
+
+Wire it in `cms.config.ts`:
+
+```ts
+import { defineConfig } from 'includio-cms/sveltekit';
+import { myDbAdapter } from './my-adapter.js';
+
+export default defineConfig({
+  db: myDbAdapter({ connection: process.env.MY_DB_URL! }),
+  // ...
+});
+```
+
+Reference implementation: [`src/lib/db-postgres/index.ts`](src/lib/db-postgres/index.ts) (drizzle + `postgres`).
+
+### Optional peer dependencies
+
+The default email + AI adapters depend on third-party SDKs that **are not installed by default**. If you use them, install the peer:
+
+| Adapter                   | Required peer            | Install                                |
+| ------------------------- | ------------------------ | -------------------------------------- |
+| `email-nodemailer`        | `nodemailer`             | `pnpm add nodemailer`                  |
+| `ai-openai`               | `openai`                 | `pnpm add openai`                      |
+| `ai-claude`               | `@anthropic-ai/sdk`      | `pnpm add @anthropic-ai/sdk`           |
+
+Each SDK is loaded lazily on first call. Missing peer throws a clear error at runtime — install it and the adapter wakes up.
+
 ## Links
 
 - [Full Documentation](DOCS.md)

package/dist/admin/api/rest/routes/collections.js

@@ -1,6 +1,6 @@
 import { json } from '@sveltejs/kit';
 import { getCMS } from '../../../../core/cms.js';
-import { getRawEntries, getRawEntry, countRawEntries } from '../../../../core/server/entries/operations/get.js';
+import { _getRawEntries as getRawEntries, _getRawEntry as getRawEntry, _countRawEntries as countRawEntries } from '../../../../core/server/entries/operations/get.js';
 import { createEntry } from '../../../../core/server/entries/operations/create.js';
 import { upsertDraftVersion, updateEntry, updateEntryVersion } from '../../../../core/server/entries/operations/update.js';
 import { deleteEntry } from '../../../../core/server/entries/operations/delete.js';

package/dist/admin/api/rest/routes/entries.js

@@ -1,6 +1,6 @@
 import { json } from '@sveltejs/kit';
 import { getCMS } from '../../../../core/cms.js';
-import { getRawEntryOrThrow } from '../../../../core/server/entries/operations/get.js';
+import { _getRawEntryOrThrow as getRawEntryOrThrow } from '../../../../core/server/entries/operations/get.js';
 import { updateEntry, updateEntryVersion, unpublishEntryLang } from '../../../../core/server/entries/operations/update.js';
 export async function POST(event, id, action) {
     const user = event.locals.user;

package/dist/admin/api/rest/routes/singletons.js

@@ -1,6 +1,6 @@
 import { json } from '@sveltejs/kit';
 import { getCMS } from '../../../../core/cms.js';
-import { getRawEntries } from '../../../../core/server/entries/operations/get.js';
+import { _getRawEntries as getRawEntries } from '../../../../core/server/entries/operations/get.js';
 import { createEntry } from '../../../../core/server/entries/operations/create.js';
 import { upsertDraftVersion } from '../../../../core/server/entries/operations/update.js';
 export async function GET(event, slug) {

package/dist/admin/remote/entry.remote.js

@@ -1,7 +1,8 @@
 import { command, query } from '$app/server';
 import { getAtPath } from '../utils/objectPath.js';
 import { createEntry as createEntryOperation, createEntrySchema, createEntryVersion } from '../../core/server/entries/operations/create.js';
-import { getRawEntries as getRawEntriesOperation, countRawEntries as countRawEntriesOperation, getRawEntry as getRawEntryOperation, getRawEntryOrThrow, getDbEntry, getDbEntryOrThrow, getEntries as getEntriesOperation, getEntry as getEntryOperation, getEntryVersion as getEntryVersionOperation, getEntryLabels as getEntryLabelsOperation } from '../../core/server/entries/operations/get.js';
+import { _getRawEntries as getRawEntriesOperation, _countRawEntries as countRawEntriesOperation, _getRawEntry as getRawEntryOperation, _getRawEntryOrThrow as getRawEntryOrThrow, _getDbEntry as getDbEntry, getEntryVersion as getEntryVersionOperation, getEntryLabels as getEntryLabelsOperation } from '../../core/server/entries/operations/get.js';
+import { resolveEntries, resolveEntry } from '../../core/server/entries/operations/resolveEntry.js';
 import { getCMS } from '../../core/cms.js';
 import { pruneOldDraftVersions, unpublishEntryLang, upsertDraftVersion, updateEntry, updateEntrySchema, updateEntryVersionCommandTypes } from '../../core/server/entries/operations/update.js';
 import z from 'zod';
@@ -42,7 +43,17 @@ export const getEntries = query(z.object({
     })
         .optional()
 }), async (input) => {
-    return getEntriesOperation(input);
+    if (!input.slug)
+        return [];
+    const status = input.status === 'draft' || input.status === 'scheduled' ? input.status : 'published';
+    return resolveEntries({
+        collection: input.slug,
+        ids: input.ids,
+        locale: input.language,
+        status,
+        filter: { dataValues: input.dataValues, dataLike: input.dataLike },
+        orderBy: input.orderBy
+    });
 });
 export const getEntryLabels = query(z.object({
     slug: z.string(),
@@ -61,7 +72,13 @@ export const getEntry = query(z.object({
     status: z.enum(entryStatuses).optional(),
     slug: z.string().optional()
 }), async (input) => {
-    return getEntryOperation(input);
+    const status = input.status === 'draft' || input.status === 'scheduled' ? input.status : 'published';
+    return resolveEntry({
+        id: input.id,
+        collection: input.slug,
+        locale: input.language,
+        status
+    });
 });
 export const createEntry = command(createEntrySchema, async (input) => {
     requireAuth();

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

@@ -5,8 +5,8 @@ export declare function createInvitation(email: string, role: UserRole, createdB
     createdAt: Date;
     email: string;
     expiresAt: Date;
-    token: string;
     createdBy: string;
+    token: string;
     usedAt: Date | null;
 }>;
 export declare function getInvitationByToken(token: string): Promise<{

package/dist/admin/remote/preview.remote.js

@@ -1,6 +1,6 @@
 import { command } from '$app/server';
 import { getCMS } from '../../core/cms.js';
-import { populateEntryData } from '../../core/server/fields/populateEntry.js';
+import { _populate } from '../../core/server/fields/populateEntry.js';
 import { getFieldsFromConfig } from '../../core/fields/layoutUtils.js';
 import z from 'zod';
 const schema = z.object({
@@ -11,6 +11,14 @@ const schema = z.object({
 export const populatePreviewData = command(schema, async ({ data, slug, language }) => {
     const config = getCMS().getBySlug(slug);
     const fields = getFieldsFromConfig(config);
-    const populated = await populateEntryData(data, fields, language);
+    const populated = await _populate(data, fields, {
+        locale: language,
+        status: 'draft',
+        depth: 0,
+        maxDepth: 5,
+        visited: new Set(),
+        populate: {},
+        entryId: ''
+    });
     return populated;
 });

package/dist/admin/remote/reorder.js

@@ -1,4 +1,4 @@
-import { getDbEntries } from '../../core/server/entries/operations/get.js';
+import { _getDbEntries as getDbEntries } from '../../core/server/entries/operations/get.js';
 import { updateEntry } from '../../core/server/entries/operations/update.js';
 export async function stableSlotReorder(orderedIds, collectionSlug) {
     if (orderedIds.length === 0)

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

@@ -88,12 +88,6 @@ export declare const listOrdersAdmin: import("@sveltejs/kit").RemoteQueryFunctio
     createdAt: Date;
     updatedAt: Date;
     language: string | null;
-    accessToken: string;
-    consents: {
-        id: string;
-        accepted: boolean;
-        label: string;
-    }[] | null;
     carrierType: string | null;
     currency: string;
     customerEmail: string;
@@ -113,7 +107,13 @@ export declare const listOrdersAdmin: import("@sveltejs/kit").RemoteQueryFunctio
     shipmentCreatedAt: Date | null;
     paymentMethod: string | null;
     paymentProviderRef: string | null;
+    consents: {
+        id: string;
+        accepted: boolean;
+        label: string;
+    }[] | null;
     notes: string | null;
+    accessToken: string;
 }[]>;
 export declare const getOrderForAdmin: import("@sveltejs/kit").RemoteQueryFunction<string, {
     order: {
@@ -123,12 +123,6 @@ export declare const getOrderForAdmin: import("@sveltejs/kit").RemoteQueryFuncti
         createdAt: Date;
         updatedAt: Date;
         language: string | null;
-        accessToken: string;
-        consents: {
-            id: string;
-            accepted: boolean;
-            label: string;
-        }[] | null;
         carrierType: string | null;
         currency: string;
         customerEmail: string;
@@ -148,7 +142,13 @@ export declare const getOrderForAdmin: import("@sveltejs/kit").RemoteQueryFuncti
         shipmentCreatedAt: Date | null;
         paymentMethod: string | null;
         paymentProviderRef: string | null;
+        consents: {
+            id: string;
+            accepted: boolean;
+            label: string;
+        }[] | null;
         notes: string | null;
+        accessToken: string;
     };
     items: {
         id: string;
@@ -182,12 +182,6 @@ export declare const updateOrderStatusCmd: import("@sveltejs/kit").RemoteCommand
     createdAt: Date;
     updatedAt: Date;
     language: string | null;
-    accessToken: string;
-    consents: {
-        id: string;
-        accepted: boolean;
-        label: string;
-    }[] | null;
     carrierType: string | null;
     currency: string;
     customerEmail: string;
@@ -207,7 +201,13 @@ export declare const updateOrderStatusCmd: import("@sveltejs/kit").RemoteCommand
     shipmentCreatedAt: Date | null;
     paymentMethod: string | null;
     paymentProviderRef: string | null;
+    consents: {
+        id: string;
+        accepted: boolean;
+        label: string;
+    }[] | null;
     notes: string | null;
+    accessToken: string;
 }>>;
 export declare const resendOrderEmailCmd: import("@sveltejs/kit").RemoteCommand<{
     orderId: string;

package/dist/ai-claude/index.d.ts

@@ -1,2 +1,11 @@
 import type { AIAdapter, AIConfig } from '../types/adapters/ai.js';
+/**
+ * Anthropic Claude AI adapter for `generateAltText`.
+ *
+ * `@anthropic-ai/sdk` is an **optional peer dependency** — install it in your
+ * project (`pnpm add @anthropic-ai/sdk`) when using this adapter. SDK loads
+ * lazily on first call; missing peer throws a clear error.
+ *
+ * @public
+ */
 export declare function claudeAdapter(config: AIConfig): AIAdapter;

package/dist/ai-claude/index.js

@@ -1,14 +1,29 @@
 import { getCMS } from '../core/cms.js';
-import Anthropic from '@anthropic-ai/sdk';
 import sharp from 'sharp';
+/**
+ * Anthropic Claude AI adapter for `generateAltText`.
+ *
+ * `@anthropic-ai/sdk` is an **optional peer dependency** — install it in your
+ * project (`pnpm add @anthropic-ai/sdk`) when using this adapter. SDK loads
+ * lazily on first call; missing peer throws a clear error.
+ *
+ * @public
+ */
 export function claudeAdapter(config) {
     let client = null;
-    function getClient() {
-        if (!client) {
-            if (!config.apiKey)
-                throw new Error('AI_CLAUDE_API_KEY is not set');
-            client = new Anthropic({ apiKey: config.apiKey });
+    async function getClient() {
+        if (client)
+            return client;
+        if (!config.apiKey)
+            throw new Error('AI_CLAUDE_API_KEY is not set');
+        let Anthropic;
+        try {
+            Anthropic = (await import('@anthropic-ai/sdk')).default;
         }
+        catch {
+            throw new Error('@anthropic-ai/sdk is required for claudeAdapter — install it with `pnpm add @anthropic-ai/sdk`');
+        }
+        client = new Anthropic({ apiKey: config.apiKey });
         return client;
     }
     return {
@@ -29,7 +44,8 @@ export function claudeAdapter(config) {
             const pngBuffer = await sharp(fileBuffer).png().toBuffer();
             const imageBase64 = pngBuffer.toString('base64');
             const prompt = `Generate a concise and descriptive alt text for the following image file in polish language. The alt text should accurately describe the content and context of the image, be no longer than 125 characters, and avoid using phrases like "image of" or "picture of". Return only the alt text, nothing else.`;
-            const message = await getClient().messages.create({
+            const anthropic = await getClient();
+            const message = await anthropic.messages.create({
                 model: 'claude-haiku-4-5-20251001',
                 max_tokens: 256,
                 messages: [

package/dist/ai-openai/index.d.ts

@@ -1,2 +1,11 @@
 import type { AIAdapter, AIConfig } from '../types/adapters/ai.js';
+/**
+ * OpenAI AI adapter for `generateAltText`.
+ *
+ * `openai` is an **optional peer dependency** — install it in your project
+ * (`pnpm add openai`) when using this adapter. SDK loads lazily on first call;
+ * missing peer throws a clear error.
+ *
+ * @public
+ */
 export declare function openAIAdapter(config: AIConfig): AIAdapter;

package/dist/ai-openai/index.js

@@ -1,12 +1,32 @@
 import { getCMS } from '../core/cms.js';
-import OpenAI from 'openai';
-import { zodResponseFormat } from 'openai/helpers/zod.mjs';
 import z from 'zod';
 import sharp from 'sharp';
+/**
+ * OpenAI AI adapter for `generateAltText`.
+ *
+ * `openai` is an **optional peer dependency** — install it in your project
+ * (`pnpm add openai`) when using this adapter. SDK loads lazily on first call;
+ * missing peer throws a clear error.
+ *
+ * @public
+ */
 export function openAIAdapter(config) {
-    const openai = new OpenAI({
-        apiKey: config.apiKey
-    });
+    let openai = null;
+    let zodResponseFormat = null;
+    async function getClient() {
+        if (openai && zodResponseFormat)
+            return { client: openai, zodResponseFormat };
+        let OpenAI;
+        try {
+            OpenAI = (await import('openai')).default;
+            zodResponseFormat = (await import('openai/helpers/zod.mjs')).zodResponseFormat;
+        }
+        catch {
+            throw new Error('openai is required for openAIAdapter — install it with `pnpm add openai`');
+        }
+        openai = new OpenAI({ apiKey: config.apiKey });
+        return { client: openai, zodResponseFormat };
+    }
     return {
         generateAltText: async (fileId) => {
             const altTextSchema = z.object({
@@ -24,13 +44,12 @@ export function openAIAdapter(config) {
             if (!file) {
                 throw new Error('File not found');
             }
-            // Konwertuj plik na PNG używając Sharp i przekonwertuj na base64
             const fileBuffer = Buffer.from(await file.arrayBuffer());
             const pngBuffer = await sharp(fileBuffer).png().toBuffer();
             const imageBase64 = pngBuffer.toString('base64');
             const prompt = `Generate a concise and descriptive alt text for the following image file in polish language. The alt text should accurately describe the content and context of the image, be no longer than 125 characters, and avoid using phrases like "image of" or "picture of".`;
-            const completion = await openai.chat.completions.parse({
-                // model: 'gpt-4.1-nano',
+            const { client, zodResponseFormat: zrf } = await getClient();
+            const completion = await client.chat.completions.parse({
                 model: 'gpt-4o',
                 messages: [
                     {
@@ -49,7 +68,7 @@ export function openAIAdapter(config) {
                         ]
                     }
                 ],
-                response_format: zodResponseFormat(altTextSchema, 'response')
+                response_format: zrf(altTextSchema, 'response')
             });
             const response = completion.choices[0].message;
             if (!response.parsed) {

package/dist/cms/runtime/api.d.ts

@@ -1,14 +1,18 @@
 import type { SingleEntryMap, SingleSlug, CollectionEntryMap, CollectionSlug, FormEntryMap, SiteLanguage } from './types';
+import { type PopulateConfig } from 'includio-cms/sveltekit/server';
 interface GetEntryOptions {
     id?: string;
-    status?: 'draft' | 'published' | 'scheduled' | 'archived';
-    dataValues?: Record<string, unknown>;
-    language?: SiteLanguage;
+    status?: 'published' | 'draft' | 'scheduled';
+    populate?: PopulateConfig;
+    locale?: SiteLanguage;
 }
 interface GetEntriesOptions extends GetEntryOptions {
     ids?: string[];
-    dataLike?: Record<string, unknown>;
-    dataILikeOr?: Record<string, unknown>;
+    filter?: {
+        dataValues?: Record<string, unknown>;
+        dataLike?: Record<string, unknown>;
+        dataILikeOr?: Record<string, unknown>;
+    };
     orderBy?: {
         column: 'createdAt' | 'updatedAt' | 'sortOrder';
         direction: 'asc' | 'desc';
@@ -23,7 +27,7 @@ interface GetEntriesOptions extends GetEntryOptions {
 export declare function getSingleEntry<K extends SingleSlug>(slug: K, options?: GetEntryOptions): Promise<SingleEntryMap[K] | null>;
 export declare function getCollectionEntry<K extends CollectionSlug>(slug: K, options?: GetEntryOptions): Promise<CollectionEntryMap[K] | null>;
 export declare function getCollectionEntries<K extends CollectionSlug>(slug: K, options?: GetEntriesOptions): Promise<CollectionEntryMap[K][]>;
-export declare function countCollectionEntries<K extends CollectionSlug>(slug: K, options?: Omit<GetEntriesOptions, 'limit' | 'offset' | 'orderBy'>): Promise<number>;
+export declare function countCollectionEntries<K extends CollectionSlug>(slug: K, options?: Omit<GetEntriesOptions, 'limit' | 'offset' | 'orderBy' | 'populate'>): Promise<number>;
 export interface SubmitFormOptions {
     ip?: string;
     userAgent?: string;

package/dist/cms/runtime/api.js

@@ -1,22 +1,22 @@
 // This file is auto-generated. Do not edit directly.
-import { getEntry, getEntries, countEntries, createFormSubmission } from 'includio-cms/sveltekit/server';
+import { resolveEntry, resolveEntries, countEntries, createFormSubmission } from 'includio-cms/sveltekit/server';
 export async function getSingleEntry(slug, options = {}) {
-    return (await getEntry({
-        slug,
+    return (await resolveEntry({
+        collection: slug,
         ...options
     }));
 }
 export async function getCollectionEntry(slug, options = {}) {
-    return (await getEntry({
-        slug,
+    return (await resolveEntry({
+        collection: slug,
         ...options
     }));
 }
 export async function getCollectionEntries(slug, options = {}) {
-    return (await getEntries({ slug, ...options }));
+    return (await resolveEntries({ collection: slug, ...options }));
 }
 export async function countCollectionEntries(slug, options = {}) {
-    return countEntries({ slug, ...options });
+    return countEntries({ collection: slug, ...options });
 }
 export async function submitForm(slug, data, options) {
     return createFormSubmission({ slug, data, ...options });

package/dist/components/ui/accordion/accordion.svelte.d.ts

@@ -1,4 +1,4 @@
 import { Accordion as AccordionPrimitive } from "bits-ui";
-declare const Accordion: import("svelte").Component<AccordionPrimitive.RootProps, {}, "value" | "ref">;
+declare const Accordion: import("svelte").Component<AccordionPrimitive.RootProps, {}, "ref" | "value">;
 type Accordion = ReturnType<typeof Accordion>;
 export default Accordion;

package/dist/components/ui/calendar/calendar.svelte.d.ts

@@ -16,6 +16,6 @@ type $$ComponentProps = WithoutChildrenOrChild<CalendarPrimitive.RootProps> & {
         outsideMonth: boolean;
     }]>;
 };
-declare const Calendar: import("svelte").Component<$$ComponentProps, {}, "value" | "ref" | "placeholder">;
+declare const Calendar: import("svelte").Component<$$ComponentProps, {}, "ref" | "value" | "placeholder">;
 type Calendar = ReturnType<typeof Calendar>;
 export default Calendar;

package/dist/components/ui/command/command-dialog.svelte.d.ts

@@ -7,6 +7,6 @@ type $$ComponentProps = WithoutChildrenOrChild<DialogPrimitive.RootProps> & With
     title?: string;
     description?: string;
 };
-declare const CommandDialog: import("svelte").Component<$$ComponentProps, {}, "value" | "ref" | "open">;
+declare const CommandDialog: import("svelte").Component<$$ComponentProps, {}, "ref" | "value" | "open">;
 type CommandDialog = ReturnType<typeof CommandDialog>;
 export default CommandDialog;

package/dist/components/ui/command/command-input.svelte.d.ts

@@ -1,4 +1,4 @@
 import { Command as CommandPrimitive } from "bits-ui";
-declare const CommandInput: import("svelte").Component<CommandPrimitive.InputProps, {}, "value" | "ref">;
+declare const CommandInput: import("svelte").Component<CommandPrimitive.InputProps, {}, "ref" | "value">;
 type CommandInput = ReturnType<typeof CommandInput>;
 export default CommandInput;

package/dist/components/ui/command/command.svelte.d.ts

@@ -3,6 +3,6 @@ export type CommandRootApi = CommandPrimitive.Root;
 type $$ComponentProps = CommandPrimitive.RootProps & {
     api?: CommandRootApi | null;
 };
-declare const Command: import("svelte").Component<$$ComponentProps, {}, "value" | "ref" | "api">;
+declare const Command: import("svelte").Component<$$ComponentProps, {}, "ref" | "value" | "api">;
 type Command = ReturnType<typeof Command>;
 export default Command;