includio-cms 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -3,7 +3,49 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
-## 0.17.0 — 2026-04-29
+## 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.
 

package/DOCS.md

@@ -1,4 +1,4 @@
-# Includio CMS Documentation (v0.18.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/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/db-postgres/index.d.ts

@@ -5,4 +5,8 @@ import type { DatabaseAdapter } from '../types/adapters/db.js';
 export type DatabaseAdapterWithDrizzle = DatabaseAdapter & {
     _drizzle: ReturnType<typeof drizzle<typeof schema>>;
 };
+/**
+ * Postgres database adapter (drizzle + `postgres`).
+ * @public
+ */
 export declare function pg(config: Config): DatabaseAdapterWithDrizzle;

package/dist/db-postgres/index.js

@@ -262,6 +262,10 @@ function buildMediaFileConditions(db, options) {
     }
     return conditions;
 }
+/**
+ * Postgres database adapter (drizzle + `postgres`).
+ * @public
+ */
 export function pg(config) {
     const client = postgres(config.databaseUrl);
     const db = drizzle(client, { schema });

package/dist/email-nodemailer/index.d.ts

@@ -5,5 +5,14 @@ interface Options {
     defaultFromName: string;
     transportOptions: SMTPTransport.Options;
 }
+/**
+ * SMTP email adapter built on `nodemailer`.
+ *
+ * `nodemailer` is an **optional peer dependency** — install it in your project
+ * (`pnpm add nodemailer`) when using this adapter. The SDK loads lazily on first
+ * `sendMail()`; missing peer throws a clear error.
+ *
+ * @public
+ */
 export declare function nodemailerAdapter(options: Options): EmailAdapter;
 export {};

package/dist/email-nodemailer/index.js

@@ -1,14 +1,36 @@
-import { createTransport } from 'nodemailer';
+/**
+ * SMTP email adapter built on `nodemailer`.
+ *
+ * `nodemailer` is an **optional peer dependency** — install it in your project
+ * (`pnpm add nodemailer`) when using this adapter. The SDK loads lazily on first
+ * `sendMail()`; missing peer throws a clear error.
+ *
+ * @public
+ */
 export function nodemailerAdapter(options) {
-    const transporter = createTransport({
-        ...options.transportOptions,
-        from: `"${options.defaultFromName}" <${options.defaultFromAddress}>`
-    });
+    let transporter = null;
+    async function getTransporter() {
+        if (transporter)
+            return transporter;
+        let createTransport;
+        try {
+            ({ createTransport } = await import('nodemailer'));
+        }
+        catch {
+            throw new Error('nodemailer is required for nodemailerAdapter — install it with `pnpm add nodemailer`');
+        }
+        transporter = createTransport({
+            ...options.transportOptions,
+            from: `"${options.defaultFromName}" <${options.defaultFromAddress}>`
+        });
+        return transporter;
+    }
     return {
         defaultFromAddress: options.defaultFromAddress,
         defaultFromName: options.defaultFromName,
         sendMail: async (sendMailOptions) => {
-            await transporter.sendMail({
+            const t = await getTransporter();
+            await t.sendMail({
                 ...sendMailOptions,
                 from: `"${options.defaultFromName}" <${options.defaultFromAddress}>`
             });

package/dist/files-local/index.d.ts

@@ -4,4 +4,8 @@ export interface LocalFilesConfig {
     ffmpegPath?: string;
     ffprobePath?: string;
 }
+/**
+ * Local-disk files adapter. Stores uploads under `./static/uploads` (dev) or `/data/uploads` (prod).
+ * @public
+ */
 export declare function local(config?: LocalFilesConfig): FilesAdapter;

package/dist/files-local/index.js

@@ -19,6 +19,10 @@ async function ensureDir(dir) {
         // Already exists
     }
 }
+/**
+ * Local-disk files adapter. Stores uploads under `./static/uploads` (dev) or `/data/uploads` (prod).
+ * @public
+ */
 export function local(config) {
     if (config?.ffmpegPath || config?.ffprobePath) {
         setFfmpegPaths(config.ffmpegPath, config.ffprobePath);

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

@@ -1,36 +1,3 @@
-export function hello_world(inputs: {
-    name: NonNullable<unknown>;
-}, options?: {
-    locale?: "en" | "pl";
-}): string;
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-*
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-declare function login_hello(inputs?: {}, options?: {
-    locale?: "en" | "pl";
-}): string;
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-*
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-declare function login_please_login(inputs?: {}, options?: {
-    locale?: "en" | "pl";
-}): string;
-export { login_hello as login.hello, login_please_login as login.please_login };
+export * from "./hello_world.js";
+export * from "./login_hello.js";
+export * from "./login_please_login.js";

package/dist/paraglide/messages/_index.js

@@ -1,72 +1,4 @@
 /* eslint-disable */
-import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from "../runtime.js"
-import * as en from "./en.js"
-import * as pl from "./pl.js"
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-* 
-* @param {{ name: NonNullable<unknown> }} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-export const hello_world = (inputs, options = {}) => {
-	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
-		return /** @type {any} */ (globalThis).__paraglide_ssr.hello_world(inputs) 
-	}
-	const locale = options.locale ?? getLocale()
-	trackMessageCall("hello_world", locale)
-	if (locale === "en") return en.hello_world(inputs)
-	return pl.hello_world(inputs)
-};
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-* 
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-const login_hello = (inputs = {}, options = {}) => {
-	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
-		return /** @type {any} */ (globalThis).__paraglide_ssr.login_hello(inputs) 
-	}
-	const locale = options.locale ?? getLocale()
-	trackMessageCall("login_hello", locale)
-	if (locale === "en") return en.login_hello(inputs)
-	return pl.login_hello(inputs)
-};
-export { login_hello as "login.hello" }
-/**
-* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
-*
-* - Changing this function will be over-written by the next build.
-*
-* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
-* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
-* 
-* @param {{}} inputs
-* @param {{ locale?: "en" | "pl" }} options
-* @returns {string}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-const login_please_login = (inputs = {}, options = {}) => {
-	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
-		return /** @type {any} */ (globalThis).__paraglide_ssr.login_please_login(inputs) 
-	}
-	const locale = options.locale ?? getLocale()
-	trackMessageCall("login_please_login", locale)
-	if (locale === "en") return en.login_please_login(inputs)
-	return pl.login_please_login(inputs)
-};
-export { login_please_login as "login.please_login" }
+export * from './hello_world.js'
+export * from './login_hello.js'
+export * from './login_please_login.js'

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

@@ -0,0 +1,5 @@
+export function hello_world(inputs: {
+    name: NonNullable<unknown>;
+}, options?: {
+    locale?: "en" | "pl";
+}): string;

package/dist/paraglide/messages/hello_world.js

@@ -0,0 +1,33 @@
+/* eslint-disable */
+import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from '../runtime.js';
+
+const en_hello_world = /** @type {(inputs: { name: NonNullable<unknown> }) => string} */ (i) => {
+	return `Hello, ${i.name} from en!`
+};
+
+const pl_hello_world = /** @type {(inputs: { name: NonNullable<unknown> }) => string} */ (i) => {
+	return `Hello, ${i.name} from pl!`
+};
+
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+* 
+* @param {{ name: NonNullable<unknown> }} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+/* @__NO_SIDE_EFFECTS__ */
+export const hello_world = (inputs, options = {}) => {
+	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
+		return /** @type {any} */ (globalThis).__paraglide_ssr.hello_world(inputs) 
+	}
+	const locale = options.locale ?? getLocale()
+	trackMessageCall("hello_world", locale)
+	if (locale === "en") return en_hello_world(inputs)
+	return pl_hello_world(inputs)
+};

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

@@ -0,0 +1,16 @@
+export { login_hello as login.hello };
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+*
+* @param {{}} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+declare function login_hello(inputs?: {}, options?: {
+    locale?: "en" | "pl";
+}): string;

package/dist/paraglide/messages/login_hello.js

@@ -0,0 +1,34 @@
+/* eslint-disable */
+import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from '../runtime.js';
+
+const en_login_hello = /** @type {(inputs: {}) => string} */ () => {
+	return `Welcome back`
+};
+
+const pl_login_hello = /** @type {(inputs: {}) => string} */ () => {
+	return `Witaj ponownie`
+};
+
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+* 
+* @param {{}} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+/* @__NO_SIDE_EFFECTS__ */
+const login_hello = (inputs = {}, options = {}) => {
+	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
+		return /** @type {any} */ (globalThis).__paraglide_ssr.login_hello(inputs) 
+	}
+	const locale = options.locale ?? getLocale()
+	trackMessageCall("login_hello", locale)
+	if (locale === "en") return en_login_hello(inputs)
+	return pl_login_hello(inputs)
+};
+export { login_hello as "login.hello" }

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

@@ -0,0 +1,16 @@
+export { login_please_login as login.please_login };
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+*
+* @param {{}} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+declare function login_please_login(inputs?: {}, options?: {
+    locale?: "en" | "pl";
+}): string;

package/dist/paraglide/messages/login_please_login.js

@@ -0,0 +1,34 @@
+/* eslint-disable */
+import { getLocale, trackMessageCall, experimentalMiddlewareLocaleSplitting, isServer } from '../runtime.js';
+
+const en_login_please_login = /** @type {(inputs: {}) => string} */ () => {
+	return `Login to your account`
+};
+
+const pl_login_please_login = /** @type {(inputs: {}) => string} */ () => {
+	return `Zaloguj się na swoje konto`
+};
+
+/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. `en.json`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+* 
+* @param {{}} inputs
+* @param {{ locale?: "en" | "pl" }} options
+* @returns {string}
+*/
+/* @__NO_SIDE_EFFECTS__ */
+const login_please_login = (inputs = {}, options = {}) => {
+	if (experimentalMiddlewareLocaleSplitting && isServer === false) {
+		return /** @type {any} */ (globalThis).__paraglide_ssr.login_please_login(inputs) 
+	}
+	const locale = options.locale ?? getLocale()
+	trackMessageCall("login_please_login", locale)
+	if (locale === "en") return en_login_please_login(inputs)
+	return pl_login_please_login(inputs)
+};
+export { login_please_login as "login.please_login" }

package/dist/types/adapters/ai.d.ts

@@ -1,11 +1,19 @@
+/** @public */
 export interface AIConfig {
     apiKey: string;
 }
+/** @public */
 export type AIAdapterConfig = {
     config: AIConfig;
     adapter: (config: AIConfig, db: AIAdapter) => AIAdapter;
 };
+/**
+ * Contract for AI adapters. Currently powers `generateAltText` (admin media UI).
+ * Default implementations: `includio-cms/ai-openai`, `includio-cms/ai-claude`.
+ * @public
+ */
 export interface AIAdapter {
     generateAltText: GenerateAltText;
 }
+/** @public */
 export type GenerateAltText = (fileId: string) => Promise<string>;

package/dist/types/adapters/db.d.ts

@@ -4,6 +4,15 @@ import type { ImageFieldStyle } from '../fields.js';
 import type { FormSubmission } from '../forms.js';
 import type { ImageStyle, MediaFile, MediaTag, UploadedMediaFile, VideoStyle, VideoStyleStatus } from '../media.js';
 export type { FilesAdapter } from './files.js';
+/**
+ * Contract for database adapters. Drives entries, versions, media, tags, form submissions,
+ * consent logs, and image/video styles. Default implementation: `includio-cms/db-postgres`.
+ *
+ * To build a custom adapter, implement every required method (optionals are marked `?`).
+ * See README — "Writing your own adapter".
+ *
+ * @public
+ */
 export interface DatabaseAdapter {
     createEntry: CreateEntry;
     getEntries: GetEntries;

package/dist/types/adapters/email.d.ts

@@ -1,4 +1,10 @@
+/** @public */
 export type EmailAdapterFactory = () => EmailAdapter;
+/**
+ * Contract for email adapters. Used by `better-auth` reset-password flow and form submission
+ * notifications. Default implementation: `includio-cms/email-nodemailer`.
+ * @public
+ */
 export interface EmailAdapter {
     sendMail: SendMail;
     defaultFromAddress: string;

package/dist/types/adapters/files.d.ts

@@ -1,4 +1,9 @@
 import type { UploadedMediaFile } from '../media.js';
+/**
+ * Contract for file storage adapters. Used by media upload pipeline + private file flow
+ * (e.g. shop receipts). Default implementation: `includio-cms/files-local`.
+ * @public
+ */
 export interface FilesAdapter {
     downloadFile: DownloadFile;
     uploadFile: UploadFile;

package/dist/updates/{0.17.0 → 0.18.0}/index.js

@@ -1,5 +1,5 @@
 export const update = {
-    version: '0.17.0',
+    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: [

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,8 +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';
-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];
+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.18.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`
-};