@btst/stack 5.0.0 → 5.2.0

package/dist/plugins/calendar/query-keys.mjs

@@ -0,0 +1,129 @@
+import { createResourceQueryKeys } from '@btst/stack/plugins/client';
+
+const calendarResources = {
+  calendarEvents: {
+    queries: {
+      list: {
+        path: "/calendar/events",
+        key: (identity) => [identity],
+        select: (data) => data
+      },
+      detail: {
+        path: "/calendar/events/:id",
+        params: (id, _identity) => ({ id }),
+        key: (id, identity) => [
+          id,
+          identity
+        ],
+        select: (data) => data
+      }
+    },
+    mutations: {
+      create: {
+        path: "@post/calendar/events",
+        method: "POST",
+        input: (data) => ({ body: data }),
+        select: (data) => data,
+        invalidates: ["calendarEvents"],
+        refresh: false
+      },
+      update: {
+        path: "@patch/calendar/events/:id",
+        method: "PATCH",
+        input: ({ id, data }) => ({
+          params: { id },
+          body: data
+        }),
+        select: (data) => data,
+        invalidates: [
+          "calendarEvents",
+          "calendarPublicEvents",
+          "calendarSlots"
+        ],
+        refresh: false
+      },
+      delete: {
+        path: "@delete/calendar/events/:id",
+        method: "DELETE",
+        input: (id) => ({ params: { id } }),
+        invalidates: [
+          "calendarEvents",
+          "calendarPublicEvents",
+          "calendarSlots"
+        ],
+        refresh: false
+      }
+    }
+  },
+  calendarPublicEvents: {
+    queries: {
+      detail: {
+        path: "/calendar/book/:slug",
+        params: (slug) => ({ slug }),
+        select: (data) => data
+      }
+    }
+  },
+  calendarSlots: {
+    queries: {
+      list: {
+        path: "/calendar/book/:slug/slots",
+        params: (slug, _date, _timezone) => ({ slug }),
+        query: (_slug, date, timezone) => ({
+          date,
+          timezone
+        }),
+        select: (data) => data
+      }
+    }
+  },
+  calendarBookings: {
+    queries: {
+      list: {
+        path: "/calendar/bookings",
+        query: (period, _identity) => ({ period }),
+        key: (period, identity) => [period, identity],
+        select: (data) => data
+      },
+      detail: {
+        path: "/calendar/cancel/:token",
+        params: (token) => ({ token }),
+        select: (data) => data
+      }
+    },
+    mutations: {
+      create: {
+        path: "@post/calendar/book/:slug",
+        method: "POST",
+        input: ({ slug, ...body }) => ({
+          params: { slug },
+          body
+        }),
+        select: (data) => data,
+        invalidates: ["calendarSlots", "calendarBookings.list"],
+        refresh: false
+      },
+      cancelHost: {
+        path: "@post/calendar/bookings/:id/cancel",
+        method: "POST",
+        input: (id) => ({ params: { id } }),
+        select: (data) => data,
+        invalidates: ["calendarSlots", "calendarBookings"],
+        refresh: false
+      },
+      cancel: {
+        path: "@post/calendar/cancel/:token",
+        method: "POST",
+        input: (token) => ({ params: { token } }),
+        select: (data) => data,
+        invalidates: ["calendarSlots", "calendarBookings"],
+        refresh: false
+      }
+    }
+  }
+};
+function createCalendarQueryKeys(client, headers) {
+  return createResourceQueryKeys(client, calendarResources, headers);
+}
+
+export { calendarResources, createCalendarQueryKeys };

package/dist/plugins/calendar/style.css

@@ -0,0 +1,4 @@
+@import "./client.css";
+
+@source "../../../src/**/*.{ts,tsx}";
+@source "../../packages/ui/src";

package/dist/plugins/client/index.d.cts

@@ -1,5 +1,5 @@
-import { p as ClientPluginDefinition } from '../../shared/stack.mRRyZBUg.cjs';
-export { C as ClientPlugin, q as ClientPluginRegistration, P as PluginOverrides, r as ResolvedClientPluginRuntime } from '../../shared/stack.mRRyZBUg.cjs';
+import { q as ClientPluginDefinition } from '../../shared/stack.BfynmtNO.cjs';
+export { C as ClientPlugin, r as ClientPluginRegistration, P as PluginOverrides, s as ResolvedClientPluginRuntime } from '../../shared/stack.BfynmtNO.cjs';
 import { Route } from '@btst/yar';
 export { Route, RouteContext, RouteDef, createRoute, createRouter, defineRoute, defineRoutes } from '@btst/yar';
 import { createClient } from 'better-call/client';

package/dist/plugins/client/index.d.mts

@@ -1,5 +1,5 @@
-import { p as ClientPluginDefinition } from '../../shared/stack.CkEz7vSt.mjs';
-export { C as ClientPlugin, q as ClientPluginRegistration, P as PluginOverrides, r as ResolvedClientPluginRuntime } from '../../shared/stack.CkEz7vSt.mjs';
+import { q as ClientPluginDefinition } from '../../shared/stack.CMWgGVTY.mjs';
+export { C as ClientPlugin, r as ClientPluginRegistration, P as PluginOverrides, s as ResolvedClientPluginRuntime } from '../../shared/stack.CMWgGVTY.mjs';
 import { Route } from '@btst/yar';
 export { Route, RouteContext, RouteDef, createRoute, createRouter, defineRoute, defineRoutes } from '@btst/yar';
 import { createClient } from 'better-call/client';

package/dist/plugins/client/index.d.ts

@@ -1,5 +1,5 @@
-import { p as ClientPluginDefinition } from '../../shared/stack.Cvnj99cs.js';
-export { C as ClientPlugin, q as ClientPluginRegistration, P as PluginOverrides, r as ResolvedClientPluginRuntime } from '../../shared/stack.Cvnj99cs.js';
+import { q as ClientPluginDefinition } from '../../shared/stack.CwCrqB8W.js';
+export { C as ClientPlugin, r as ClientPluginRegistration, P as PluginOverrides, s as ResolvedClientPluginRuntime } from '../../shared/stack.CwCrqB8W.js';
 import { Route } from '@btst/yar';
 export { Route, RouteContext, RouteDef, createRoute, createRouter, defineRoute, defineRoutes } from '@btst/yar';
 import { createClient } from 'better-call/client';

package/dist/plugins/cms/api/index.cjs

@@ -15,6 +15,7 @@ exports.getAllContentItems = getters.getAllContentItems;
 exports.getAllContentTypes = getters.getAllContentTypes;
 exports.getContentItemById = getters.getContentItemById;
 exports.getContentItemBySlug = getters.getContentItemBySlug;
+exports.getContentItemsByRelation = getters.getContentItemsByRelation;
 exports.serializeContentItem = getters.serializeContentItem;
 exports.serializeContentItemWithType = getters.serializeContentItemWithType;
 exports.serializeContentType = getters.serializeContentType;

package/dist/plugins/cms/api/index.d.cts

@@ -1,11 +1,11 @@
-export { C as CMSApiRouter, b as CMSRouteKey, c as CMS_QUERY_KEYS, d as cmsBackendPlugin } from '../../../shared/stack.CAmVUwjV.cjs';
+export { C as CMSApiRouter, b as CMSRouteKey, c as CMS_QUERY_KEYS, d as cmsBackendPlugin } from '../../../shared/stack.BOPL8tC3.cjs';
 import { DBAdapter } from '@btst/db';
-import { a as SerializedContentItemWithType, S as SerializedContentType, b as ContentItem, c as SerializedContentItem, d as ContentItemWithType, e as ContentType } from '../../../shared/stack.3rxARhgS.cjs';
-export { C as CMSBackendConfig, f as CMSBackendHooks, g as CMSCreateOperationContext, h as CMSCreateResultContext, i as CMSDeleteOperationContext, j as CMSDeleteResultContext, k as CMSOperationErrorContext, l as CMSOperationLifecycleContext, m as CMSUpdateOperationContext, n as CMSUpdateResultContext, o as ContentTypeConfig } from '../../../shared/stack.3rxARhgS.cjs';
+import { a as CMSReadView, c as CMSContentFields, C as CMSReadOptions, d as CMSContentItemResult, S as SerializedContentType, h as ContentItem, i as SerializedContentItem, j as ContentItemWithType, b as SerializedContentItemWithType, k as ContentType } from '../../../shared/stack.DrB3L7Ih.cjs';
+export { f as CMSBackendConfig, l as CMSBackendHooks, m as CMSCreateOperationContext, n as CMSCreateResultContext, o as CMSDeleteOperationContext, p as CMSDeleteResultContext, q as CMSOperationErrorContext, r as CMSOperationLifecycleContext, g as CMSSelectedData, s as CMSUpdateOperationContext, t as CMSUpdateResultContext, u as ContentTypeConfig, P as PaginatedContentItems, v as SerializedContentItemContent } from '../../../shared/stack.DrB3L7Ih.cjs';
 export { createCMSQueryKeys } from '../query-keys.cjs';
 import { z } from 'zod';
-import '@btst/stack/plugins/api';
 import '../../../authorization/index.cjs';
+import '@btst/stack/plugins/api';
 import 'better-call';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
@@ -65,13 +65,13 @@ declare function getAllContentTypes(adapter: DBAdapter): Promise<SerializedConte
  * @param params - Optional filter/pagination parameters. `search` matches
  * case-insensitively against item slugs and string values in the item data.
  */
-declare function getAllContentItems(adapter: DBAdapter, contentTypeSlug: string, params?: {
+declare function getAllContentItems<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, params?: {
     slug?: string;
     limit?: number;
     offset?: number;
     search?: string;
-}): Promise<{
-    items: SerializedContentItemWithType[];
+} & CMSReadOptions<TView, TFields>): Promise<{
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
     total: number;
     limit?: number;
     offset?: number;
@@ -87,7 +87,7 @@ declare function getAllContentItems(adapter: DBAdapter, contentTypeSlug: string,
  * @param adapter - The database adapter
  * @param id - The content item ID (UUID)
  */
-declare function getContentItemById(adapter: DBAdapter, id: string): Promise<SerializedContentItemWithType | null>;
+declare function getContentItemById<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, id: string, options?: CMSReadOptions<TView, TFields>): Promise<CMSContentItemResult<Record<string, unknown>, TView, TFields> | null>;
 /**
  * Retrieve a single content item by its slug within a content type.
  * Returns null if the content type or item is not found.
@@ -100,7 +100,39 @@ declare function getContentItemById(adapter: DBAdapter, id: string): Promise<Ser
  * @param contentTypeSlug - The slug of the content type
  * @param slug - The slug of the content item
  */
-declare function getContentItemBySlug(adapter: DBAdapter, contentTypeSlug: string, slug: string): Promise<SerializedContentItemWithType | null>;
+declare function getContentItemBySlug<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, slug: string, options?: CMSReadOptions<TView, TFields>): Promise<CMSContentItemResult<Record<string, unknown>, TView, TFields> | null>;
+/** Parameters for a page of items referencing one relation target. */
+interface ContentItemsByRelationParams<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> extends CMSReadOptions<TView, TFields> {
+    /** Declared top-level relation field on the source content type. */
+    field: string;
+    /** ID of the item referenced by the relation. */
+    targetId: string;
+    /** Number of items to return (default: 20). */
+    limit?: number;
+    /** Number of matching items to skip (default: 0). */
+    offset?: number;
+}
+/** A page of unique related items, ordered by creation time then ID descending. */
+interface ContentItemsByRelationResult<TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Retrieve source items whose relation field references a target item.
+ * Relation rows are scanned completely, metadata is read in batches, and full
+ * content is fetched only for the requested page. Internal scans grow with the
+ * relation count; this does not promise constant query counts or native joins.
+ * Set `view: "content"` for identity, parsed content and serialized timestamps
+ * without the editor envelope. Omitting it preserves the full item response.
+ *
+ * @remarks This lower-level read does not authorize requests, validate relation
+ * configuration or target access, or compose lifecycle hooks. Callers own those
+ * checks and pagination validation. Use `forRequest(request).operations.cms` for
+ * request work or trusted operations for validated, lifecycle-aware server work.
+ */
+declare function getContentItemsByRelation<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, params: ContentItemsByRelationParams<TView, TFields>): Promise<ContentItemsByRelationResult<TView, TFields>>;
 
 declare const CMSContentTypeParamsSchema: z.ZodObject<{
     slug: z.ZodString;
@@ -174,5 +206,5 @@ interface CreateCMSContentItemOptions {
  */
 declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
 
-export { CMSContentItemParamsSchema, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSUpdateContentItemBodySchema, CMS_LIFECYCLE_HOOK_MIGRATIONS, createCMSContentItem, getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, serializeContentItem, serializeContentItemWithType, serializeContentType };
-export type { CreateCMSContentItemInput, CreateCMSContentItemOptions };
+export { CMSContentFields, CMSContentItemParamsSchema, CMSContentItemResult, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSReadOptions, CMSReadView, CMSUpdateContentItemBodySchema, CMS_LIFECYCLE_HOOK_MIGRATIONS, createCMSContentItem, getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, getContentItemsByRelation, serializeContentItem, serializeContentItemWithType, serializeContentType };
+export type { ContentItemsByRelationParams, ContentItemsByRelationResult, CreateCMSContentItemInput, CreateCMSContentItemOptions };

package/dist/plugins/cms/api/index.d.mts

@@ -1,11 +1,11 @@
-export { C as CMSApiRouter, b as CMSRouteKey, c as CMS_QUERY_KEYS, d as cmsBackendPlugin } from '../../../shared/stack.D9x1fR5a.mjs';
+export { C as CMSApiRouter, b as CMSRouteKey, c as CMS_QUERY_KEYS, d as cmsBackendPlugin } from '../../../shared/stack.DQvIorwF.mjs';
 import { DBAdapter } from '@btst/db';
-import { a as SerializedContentItemWithType, S as SerializedContentType, b as ContentItem, c as SerializedContentItem, d as ContentItemWithType, e as ContentType } from '../../../shared/stack.3rxARhgS.mjs';
-export { C as CMSBackendConfig, f as CMSBackendHooks, g as CMSCreateOperationContext, h as CMSCreateResultContext, i as CMSDeleteOperationContext, j as CMSDeleteResultContext, k as CMSOperationErrorContext, l as CMSOperationLifecycleContext, m as CMSUpdateOperationContext, n as CMSUpdateResultContext, o as ContentTypeConfig } from '../../../shared/stack.3rxARhgS.mjs';
+import { a as CMSReadView, c as CMSContentFields, C as CMSReadOptions, d as CMSContentItemResult, S as SerializedContentType, h as ContentItem, i as SerializedContentItem, j as ContentItemWithType, b as SerializedContentItemWithType, k as ContentType } from '../../../shared/stack.DrB3L7Ih.mjs';
+export { f as CMSBackendConfig, l as CMSBackendHooks, m as CMSCreateOperationContext, n as CMSCreateResultContext, o as CMSDeleteOperationContext, p as CMSDeleteResultContext, q as CMSOperationErrorContext, r as CMSOperationLifecycleContext, g as CMSSelectedData, s as CMSUpdateOperationContext, t as CMSUpdateResultContext, u as ContentTypeConfig, P as PaginatedContentItems, v as SerializedContentItemContent } from '../../../shared/stack.DrB3L7Ih.mjs';
 export { createCMSQueryKeys } from '../query-keys.mjs';
 import { z } from 'zod';
-import '@btst/stack/plugins/api';
 import '../../../authorization/index.mjs';
+import '@btst/stack/plugins/api';
 import 'better-call';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
@@ -65,13 +65,13 @@ declare function getAllContentTypes(adapter: DBAdapter): Promise<SerializedConte
  * @param params - Optional filter/pagination parameters. `search` matches
  * case-insensitively against item slugs and string values in the item data.
  */
-declare function getAllContentItems(adapter: DBAdapter, contentTypeSlug: string, params?: {
+declare function getAllContentItems<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, params?: {
     slug?: string;
     limit?: number;
     offset?: number;
     search?: string;
-}): Promise<{
-    items: SerializedContentItemWithType[];
+} & CMSReadOptions<TView, TFields>): Promise<{
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
     total: number;
     limit?: number;
     offset?: number;
@@ -87,7 +87,7 @@ declare function getAllContentItems(adapter: DBAdapter, contentTypeSlug: string,
  * @param adapter - The database adapter
  * @param id - The content item ID (UUID)
  */
-declare function getContentItemById(adapter: DBAdapter, id: string): Promise<SerializedContentItemWithType | null>;
+declare function getContentItemById<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, id: string, options?: CMSReadOptions<TView, TFields>): Promise<CMSContentItemResult<Record<string, unknown>, TView, TFields> | null>;
 /**
  * Retrieve a single content item by its slug within a content type.
  * Returns null if the content type or item is not found.
@@ -100,7 +100,39 @@ declare function getContentItemById(adapter: DBAdapter, id: string): Promise<Ser
  * @param contentTypeSlug - The slug of the content type
  * @param slug - The slug of the content item
  */
-declare function getContentItemBySlug(adapter: DBAdapter, contentTypeSlug: string, slug: string): Promise<SerializedContentItemWithType | null>;
+declare function getContentItemBySlug<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, slug: string, options?: CMSReadOptions<TView, TFields>): Promise<CMSContentItemResult<Record<string, unknown>, TView, TFields> | null>;
+/** Parameters for a page of items referencing one relation target. */
+interface ContentItemsByRelationParams<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> extends CMSReadOptions<TView, TFields> {
+    /** Declared top-level relation field on the source content type. */
+    field: string;
+    /** ID of the item referenced by the relation. */
+    targetId: string;
+    /** Number of items to return (default: 20). */
+    limit?: number;
+    /** Number of matching items to skip (default: 0). */
+    offset?: number;
+}
+/** A page of unique related items, ordered by creation time then ID descending. */
+interface ContentItemsByRelationResult<TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Retrieve source items whose relation field references a target item.
+ * Relation rows are scanned completely, metadata is read in batches, and full
+ * content is fetched only for the requested page. Internal scans grow with the
+ * relation count; this does not promise constant query counts or native joins.
+ * Set `view: "content"` for identity, parsed content and serialized timestamps
+ * without the editor envelope. Omitting it preserves the full item response.
+ *
+ * @remarks This lower-level read does not authorize requests, validate relation
+ * configuration or target access, or compose lifecycle hooks. Callers own those
+ * checks and pagination validation. Use `forRequest(request).operations.cms` for
+ * request work or trusted operations for validated, lifecycle-aware server work.
+ */
+declare function getContentItemsByRelation<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, params: ContentItemsByRelationParams<TView, TFields>): Promise<ContentItemsByRelationResult<TView, TFields>>;
 
 declare const CMSContentTypeParamsSchema: z.ZodObject<{
     slug: z.ZodString;
@@ -174,5 +206,5 @@ interface CreateCMSContentItemOptions {
  */
 declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
 
-export { CMSContentItemParamsSchema, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSUpdateContentItemBodySchema, CMS_LIFECYCLE_HOOK_MIGRATIONS, createCMSContentItem, getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, serializeContentItem, serializeContentItemWithType, serializeContentType };
-export type { CreateCMSContentItemInput, CreateCMSContentItemOptions };
+export { CMSContentFields, CMSContentItemParamsSchema, CMSContentItemResult, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSReadOptions, CMSReadView, CMSUpdateContentItemBodySchema, CMS_LIFECYCLE_HOOK_MIGRATIONS, createCMSContentItem, getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, getContentItemsByRelation, serializeContentItem, serializeContentItemWithType, serializeContentType };
+export type { ContentItemsByRelationParams, ContentItemsByRelationResult, CreateCMSContentItemInput, CreateCMSContentItemOptions };

package/dist/plugins/cms/api/index.d.ts

@@ -1,11 +1,11 @@
-export { C as CMSApiRouter, b as CMSRouteKey, c as CMS_QUERY_KEYS, d as cmsBackendPlugin } from '../../../shared/stack.CQK02ujt.js';
+export { C as CMSApiRouter, b as CMSRouteKey, c as CMS_QUERY_KEYS, d as cmsBackendPlugin } from '../../../shared/stack.2N0XTU-8.js';
 import { DBAdapter } from '@btst/db';
-import { a as SerializedContentItemWithType, S as SerializedContentType, b as ContentItem, c as SerializedContentItem, d as ContentItemWithType, e as ContentType } from '../../../shared/stack.3rxARhgS.js';
-export { C as CMSBackendConfig, f as CMSBackendHooks, g as CMSCreateOperationContext, h as CMSCreateResultContext, i as CMSDeleteOperationContext, j as CMSDeleteResultContext, k as CMSOperationErrorContext, l as CMSOperationLifecycleContext, m as CMSUpdateOperationContext, n as CMSUpdateResultContext, o as ContentTypeConfig } from '../../../shared/stack.3rxARhgS.js';
+import { a as CMSReadView, c as CMSContentFields, C as CMSReadOptions, d as CMSContentItemResult, S as SerializedContentType, h as ContentItem, i as SerializedContentItem, j as ContentItemWithType, b as SerializedContentItemWithType, k as ContentType } from '../../../shared/stack.DrB3L7Ih.js';
+export { f as CMSBackendConfig, l as CMSBackendHooks, m as CMSCreateOperationContext, n as CMSCreateResultContext, o as CMSDeleteOperationContext, p as CMSDeleteResultContext, q as CMSOperationErrorContext, r as CMSOperationLifecycleContext, g as CMSSelectedData, s as CMSUpdateOperationContext, t as CMSUpdateResultContext, u as ContentTypeConfig, P as PaginatedContentItems, v as SerializedContentItemContent } from '../../../shared/stack.DrB3L7Ih.js';
 export { createCMSQueryKeys } from '../query-keys.js';
 import { z } from 'zod';
-import '@btst/stack/plugins/api';
 import '../../../authorization/index.js';
+import '@btst/stack/plugins/api';
 import 'better-call';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
@@ -65,13 +65,13 @@ declare function getAllContentTypes(adapter: DBAdapter): Promise<SerializedConte
  * @param params - Optional filter/pagination parameters. `search` matches
  * case-insensitively against item slugs and string values in the item data.
  */
-declare function getAllContentItems(adapter: DBAdapter, contentTypeSlug: string, params?: {
+declare function getAllContentItems<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, params?: {
     slug?: string;
     limit?: number;
     offset?: number;
     search?: string;
-}): Promise<{
-    items: SerializedContentItemWithType[];
+} & CMSReadOptions<TView, TFields>): Promise<{
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
     total: number;
     limit?: number;
     offset?: number;
@@ -87,7 +87,7 @@ declare function getAllContentItems(adapter: DBAdapter, contentTypeSlug: string,
  * @param adapter - The database adapter
  * @param id - The content item ID (UUID)
  */
-declare function getContentItemById(adapter: DBAdapter, id: string): Promise<SerializedContentItemWithType | null>;
+declare function getContentItemById<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, id: string, options?: CMSReadOptions<TView, TFields>): Promise<CMSContentItemResult<Record<string, unknown>, TView, TFields> | null>;
 /**
  * Retrieve a single content item by its slug within a content type.
  * Returns null if the content type or item is not found.
@@ -100,7 +100,39 @@ declare function getContentItemById(adapter: DBAdapter, id: string): Promise<Ser
  * @param contentTypeSlug - The slug of the content type
  * @param slug - The slug of the content item
  */
-declare function getContentItemBySlug(adapter: DBAdapter, contentTypeSlug: string, slug: string): Promise<SerializedContentItemWithType | null>;
+declare function getContentItemBySlug<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, slug: string, options?: CMSReadOptions<TView, TFields>): Promise<CMSContentItemResult<Record<string, unknown>, TView, TFields> | null>;
+/** Parameters for a page of items referencing one relation target. */
+interface ContentItemsByRelationParams<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> extends CMSReadOptions<TView, TFields> {
+    /** Declared top-level relation field on the source content type. */
+    field: string;
+    /** ID of the item referenced by the relation. */
+    targetId: string;
+    /** Number of items to return (default: 20). */
+    limit?: number;
+    /** Number of matching items to skip (default: 0). */
+    offset?: number;
+}
+/** A page of unique related items, ordered by creation time then ID descending. */
+interface ContentItemsByRelationResult<TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Retrieve source items whose relation field references a target item.
+ * Relation rows are scanned completely, metadata is read in batches, and full
+ * content is fetched only for the requested page. Internal scans grow with the
+ * relation count; this does not promise constant query counts or native joins.
+ * Set `view: "content"` for identity, parsed content and serialized timestamps
+ * without the editor envelope. Omitting it preserves the full item response.
+ *
+ * @remarks This lower-level read does not authorize requests, validate relation
+ * configuration or target access, or compose lifecycle hooks. Callers own those
+ * checks and pagination validation. Use `forRequest(request).operations.cms` for
+ * request work or trusted operations for validated, lifecycle-aware server work.
+ */
+declare function getContentItemsByRelation<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, params: ContentItemsByRelationParams<TView, TFields>): Promise<ContentItemsByRelationResult<TView, TFields>>;
 
 declare const CMSContentTypeParamsSchema: z.ZodObject<{
     slug: z.ZodString;
@@ -174,5 +206,5 @@ interface CreateCMSContentItemOptions {
  */
 declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
 
-export { CMSContentItemParamsSchema, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSUpdateContentItemBodySchema, CMS_LIFECYCLE_HOOK_MIGRATIONS, createCMSContentItem, getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, serializeContentItem, serializeContentItemWithType, serializeContentType };
-export type { CreateCMSContentItemInput, CreateCMSContentItemOptions };
+export { CMSContentFields, CMSContentItemParamsSchema, CMSContentItemResult, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSReadOptions, CMSReadView, CMSUpdateContentItemBodySchema, CMS_LIFECYCLE_HOOK_MIGRATIONS, createCMSContentItem, getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, getContentItemsByRelation, serializeContentItem, serializeContentItemWithType, serializeContentType };
+export type { ContentItemsByRelationParams, ContentItemsByRelationResult, CreateCMSContentItemInput, CreateCMSContentItemOptions };

package/dist/plugins/cms/api/index.mjs

@@ -1,5 +1,5 @@
 export { cmsBackendPlugin } from '../../../packages/stack/src/plugins/cms/api/plugin.mjs';
-export { getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, serializeContentItem, serializeContentItemWithType, serializeContentType } from '../../../packages/stack/src/plugins/cms/api/getters.mjs';
+export { getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, getContentItemsByRelation, serializeContentItem, serializeContentItemWithType, serializeContentType } from '../../../packages/stack/src/plugins/cms/api/getters.mjs';
 export { createCMSContentItem } from '../../../packages/stack/src/plugins/cms/api/mutations.mjs';
 export { CMS_QUERY_KEYS } from '../../../packages/stack/src/plugins/cms/api/query-key-defs.mjs';
 export { createCMSQueryKeys } from '../query-keys.mjs';