includio-cms 0.37.2 → 0.37.4

package/dist/types/cms.schema.d.ts

@@ -22,6 +22,11 @@ export declare const cmsConfigSchema: z.ZodObject<{
         code: z.ZodString;
         label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
         default: z.ZodOptional<z.ZodBoolean>;
+        url: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            pathPrefix: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            host: z.ZodString;
+        }, z.core.$strip>]>>;
     }, z.core.$loose>]>>;
     collections: z.ZodOptional<z.ZodArray<z.ZodObject<{
         entryAdminTitle: z.ZodOptional<z.ZodString>;
@@ -31,6 +36,10 @@ export declare const cmsConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
         orderable: z.ZodOptional<z.ZodBoolean>;
         listColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        defaultPopulate: z.ZodOptional<z.ZodObject<{
+            select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            depth: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
         slug: z.ZodString;
         sidebarIcon: z.ZodOptional<z.ZodString>;
         previewUrl: z.ZodOptional<z.ZodString>;
@@ -256,6 +265,10 @@ export declare const _internal: {
         }, z.core.$strip>>;
         orderable: z.ZodOptional<z.ZodBoolean>;
         listColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        defaultPopulate: z.ZodOptional<z.ZodObject<{
+            select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            depth: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
         slug: z.ZodString;
         sidebarIcon: z.ZodOptional<z.ZodString>;
         previewUrl: z.ZodOptional<z.ZodString>;
@@ -382,6 +395,11 @@ export declare const _internal: {
             code: z.ZodString;
             label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
             default: z.ZodOptional<z.ZodBoolean>;
+            url: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+                pathPrefix: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                host: z.ZodString;
+            }, z.core.$strip>]>>;
         }, z.core.$loose>]>>;
         collections: z.ZodOptional<z.ZodArray<z.ZodObject<{
             entryAdminTitle: z.ZodOptional<z.ZodString>;
@@ -391,6 +409,10 @@ export declare const _internal: {
             }, z.core.$strip>>;
             orderable: z.ZodOptional<z.ZodBoolean>;
             listColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            defaultPopulate: z.ZodOptional<z.ZodObject<{
+                select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                depth: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
             slug: z.ZodString;
             sidebarIcon: z.ZodOptional<z.ZodString>;
             previewUrl: z.ZodOptional<z.ZodString>;

package/dist/types/cms.schema.js

@@ -24,7 +24,13 @@ const languageEntrySchema = z.union([
             message: "must be a 2-letter ISO code (e.g. 'en' or 'pl-PL')"
         }),
         label: localizedSchema.optional(),
-        default: z.boolean().optional()
+        default: z.boolean().optional(),
+        url: z
+            .union([
+            z.object({ pathPrefix: z.string().startsWith('/') }),
+            z.object({ host: z.string() })
+        ])
+            .optional()
     })
         .passthrough()
 ]);
@@ -73,6 +79,10 @@ const optionItemSchema = z.object({
     label: localizedSchema.optional(),
     value: z.string()
 });
+const relationPopulateSchema = z.object({
+    select: z.array(z.string()).optional(),
+    depth: z.number().int().min(0).optional()
+});
 const fieldSchema = z.lazy(() => z.discriminatedUnion('type', [
     // text
     z
@@ -192,7 +202,8 @@ const fieldSchema = z.lazy(() => z.discriminatedUnion('type', [
         type: z.literal('relation'),
         collection: z.string().min(1, { message: 'relation.collection is required' }),
         multiple: z.boolean().optional(),
-        displayField: z.string().optional()
+        displayField: z.string().optional(),
+        populate: relationPopulateSchema.optional()
     })
         .passthrough(),
     // object
@@ -375,7 +386,8 @@ const collectionSchema = z
     })
         .optional(),
     orderable: z.boolean().optional(),
-    listColumns: z.array(z.string()).optional()
+    listColumns: z.array(z.string()).optional(),
+    defaultPopulate: relationPopulateSchema.optional()
 })
     .passthrough();
 const singleSchema = z

package/dist/types/collections.d.ts

@@ -1,5 +1,6 @@
 import type { ConfigBase } from './config.js';
 import type { Localized } from './languages.js';
+import type { RelationPopulate } from './fields.js';
 export interface CollectionConfig extends ConfigBase {
     entryAdminTitle?: string;
     labels?: {
@@ -8,6 +9,8 @@ export interface CollectionConfig extends ConfigBase {
     };
     orderable?: boolean;
     listColumns?: string[];
+    /** Domyślna chuda populacja dla każdej relacji wskazującej tę kolekcję. Nadpisywalna przez `RelationField.populate`. @public */
+    defaultPopulate?: RelationPopulate;
 }
 export interface CollectionConfigWithType extends CollectionConfig {
     type: 'collection';

package/dist/types/entries.d.ts

@@ -54,6 +54,8 @@ export interface DbEntryVersion {
     publishedAt: Date | null;
     publishedBy: string | null;
 }
+/** Metadane wersji bez pola `data` (do wyboru wersji bez ściągania blobu JSON). */
+export type DbEntryVersionMeta = Omit<DbEntryVersion, 'data'>;
 export interface DbEntryVersionInsert {
     entryId: string;
     lang: string;

package/dist/types/fields.d.ts

@@ -156,12 +156,24 @@ export interface CheckboxesField extends BaseField {
     }[];
     defaultValue?: string | string[];
 }
+/**
+ * Chuda populacja relacji: allowlist populowanych pól + cap głębokości.
+ * @public
+ */
+export interface RelationPopulate {
+    /** Allowlist slugów top-level pól docelowej kolekcji. Omit = wszystkie pola. */
+    select?: string[];
+    /** Cap rekurencji poddrzewa. 0 = relacje w środku zostają surowym ID. Nadpisuje globalny maxDepth. */
+    depth?: number;
+}
 export interface RelationField extends BaseField {
     type: 'relation';
     collection: string;
     multiple?: boolean;
     displayField?: string;
     defaultValue?: string | string[];
+    /** Domyślna chuda populacja tego pola. Nadpisuje `defaultPopulate` kolekcji docelowej. @public */
+    populate?: RelationPopulate;
 }
 export type RelationFieldData = string | string[];
 export interface ObjectField extends BaseField {

package/dist/types/languages.d.ts

@@ -1,4 +1,17 @@
 import type { locales } from '../paraglide/runtime.js';
 export type Language = 'en' | 'pl';
+/** Wpis `cms.config.languages`: kod ISO albo obiekt z domyślnością/strategią URL. */
+export type LanguageEntry = string | {
+    code: string;
+    label?: Localized;
+    default?: boolean;
+    url?: {
+        pathPrefix?: string;
+    } | {
+        host?: string;
+    };
+};
+/** Kod locale z wpisu (string lub `{ code }`). */
+export declare const languageCode: (l: LanguageEntry) => string;
 export type InterfaceLanguage = (typeof locales)[number];
 export type Localized = Partial<Record<InterfaceLanguage, string>> | string;

package/dist/types/languages.js

@@ -1 +1,2 @@
-export {};
+/** Kod locale z wpisu (string lub `{ code }`). */
+export const languageCode = (l) => (typeof l === 'string' ? l : l.code);

package/dist/updates/0.37.4/index.d.ts

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

package/dist/updates/0.37.4/index.js

@@ -0,0 +1,17 @@
+export const update = {
+    version: '0.37.4',
+    date: '2026-07-20',
+    description: 'Wydajność populacji: chude relacje/listy (opt-in `select`/`populate`) + mniejszy over-fetch wersji + indeksy ścieżki treści. Wyszło z diagnozy wolnych podstron u pod-zwrotnikami (bloki-listy ciągnące pełne media/relacje).',
+    features: [
+        '**Chuda populacja relacji (`select`/`depth`) — trzy warstwy.** Na polu relacji `populate: { select: ["title", "hero"], depth: 0 }`, na kolekcji docelowej `defaultPopulate`, oraz per-call `resolveEntry(s)({ populate: { select, fields } })`. Precedencja: call > pole > kolekcja > pełna populacja (domyślnie, wstecznie zgodnie). `select` tnie także pola **media** — galeria nie jest już populowana, gdy widok czyta tylko `heroImage`. Meta (`_id/_slug/_url/...`) zawsze obecne.',
+        '**`resolveEntries({ populate: { select: [...] } })` dla list/bloków.** Chudy widok listy bez ciągnięcia pełnego drzewa każdego wpisu (media + relacje).'
+    ],
+    fixes: [
+        '**Mniejszy over-fetch wersji.** Wybór wersji czyta teraz tylko metadane (`getEntryVersionsMeta`, bez kolumny `data`), a pełne dane hydratują się wyłącznie dla wybranej wersji (`getEntryVersionData`). Wcześniej każda relacja/wpis ciągnął pełny JSON wszystkich swoich wersji i wybierał najnowszą w JS — koszt mnożony przez głębokość i liczbę wpisów.',
+        '**Indeksy ścieżki treści.** `entry(slug)`, `entry(type)`, `entry_version(entry_id, lang, version_number)`, `entry_version(entry_id, published_at)`, `media_file_tag(tag_id)`. Aplikowane przy `db:push`.'
+    ],
+    breakingChanges: [
+        '**Kontrakt `DatabaseAdapter`: nowe wymagane metody `getEntryVersionsMeta` + `getEntryVersionData`.** Dotyczy wyłącznie własnych implementacji adaptera DB (oficjalny `db-postgres` zaktualizowany). `getEntryVersions` (pełne wersje) pozostaje bez zmian.'
+    ],
+    notes: 'Indeksy z tego wydania wchodzą przy najbliższym `pnpm db:push` w projekcie klienta — brak osobnej migracji SQL.'
+};

package/dist/updates/index.js

@@ -78,6 +78,7 @@ import { update as update0369 } from './0.36.9/index.js';
 import { update as update0370 } from './0.37.0/index.js';
 import { update as update0371 } from './0.37.1/index.js';
 import { update as update0372 } from './0.37.2/index.js';
+import { update as update0374 } from './0.37.4/index.js';
 export const updates = [
     update0065,
     update0066,
@@ -158,7 +159,8 @@ export const updates = [
     update0369,
     update0370,
     update0371,
-    update0372
+    update0372,
+    update0374
 ];
 export const getUpdatesFrom = (fromVersion) => {
     const fromParts = fromVersion.split('.').map(Number);

package/package.json

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