@btst/stack 5.0.0 → 5.1.0

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.Rb87lHqK.cjs';
+export { C as ClientPlugin, r as ClientPluginRegistration, P as PluginOverrides, s as ResolvedClientPluginRuntime } from '../../shared/stack.Rb87lHqK.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.C2Pvl-RS.mjs';
+export { C as ClientPlugin, r as ClientPluginRegistration, P as PluginOverrides, s as ResolvedClientPluginRuntime } from '../../shared/stack.C2Pvl-RS.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.BB9tubJJ.js';
+export { C as ClientPlugin, r as ClientPluginRegistration, P as PluginOverrides, s as ResolvedClientPluginRuntime } from '../../shared/stack.BB9tubJJ.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.NNrBKBkM.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.DFGj0gb7.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.Bw09Lg2z.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';

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

@@ -1,5 +1,6 @@
 import { ResourceFormConfig, ResourceFormResult, ResourceSelectResult } from '@btst/stack/plugins/client/hooks';
-import { a as SerializedContentItemWithType, S as SerializedContentType, I as InverseRelation } from '../../../../shared/stack.3rxARhgS.cjs';
+import { b as SerializedContentItemWithType, S as SerializedContentType, e as CMSContentTypeMap, I as InverseRelation } from '../../../../shared/stack.DrB3L7Ih.cjs';
+import { CMSReadView, CMSContentFields, CMSReadOptions, CMSContentItemResult } from '../../api/index.cjs';
 import 'zod';
 
 interface UseContentTypesResult {
@@ -32,7 +33,7 @@ declare function useContentType(slug: string): {
     error: Error | null;
     refetch: () => void;
 };
-interface UseContentOptions {
+interface UseContentOptions<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> extends CMSReadOptions<TView, TFields> {
     /** Number of items per page (default: 10) */
     limit?: number;
     /** Whether to enable the query (default: true) */
@@ -44,9 +45,9 @@ interface UseContentOptions {
  * Result type for useContent hook with load more functionality
  * @template TData - The type of parsedData (defaults to Record<string, unknown>)
  */
-interface UseContentResult<TData = Record<string, unknown>> {
+interface UseContentResult<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
     /** Array of all loaded content items */
-    items: SerializedContentItemWithType<TData>[];
+    items: CMSContentItemResult<TData, TView, TFields>[];
     /** Total number of items available */
     total: number;
     /** Whether the initial load is in progress */
@@ -84,21 +85,38 @@ interface UseContentResult<TData = Record<string, unknown>> {
  * // items[0].parsedData.price is number
  * ```
  */
-declare function useContent<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, options?: UseContentOptions): UseContentResult<TMap[TSlug]>;
+declare function useContent<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, const TFields extends readonly string[] = readonly string[]>(typeSlug: TSlug & string, options: UseContentOptions<"content", TFields> & {
+    view: "content";
+    fields: TFields;
+}): UseContentResult<TMap[TSlug], "content", TFields>;
+declare function useContent<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, options: UseContentOptions<"content"> & {
+    view: "content";
+    fields?: undefined;
+}): UseContentResult<TMap[TSlug], "content">;
+declare function useContent<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined>(typeSlug: TSlug & string, options?: UseContentOptions<TView, TFields>): UseContentResult<TMap[TSlug], TView, TFields>;
 /**
  * Suspense variant of useContent with load more functionality.
  *
  * @template TMap - A type map of content type slugs to their data types
  * @template TSlug - The content type slug (inferred from typeSlug parameter)
  */
-declare function useSuspenseContent<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, options?: UseContentOptions): {
-    items: SerializedContentItemWithType<TMap[TSlug]>[];
+type SuspenseContentResult<TData, TView extends CMSReadView, TFields extends CMSContentFields = undefined> = {
+    items: CMSContentItemResult<TData, TView, TFields>[];
     total: number;
     loadMore: () => Promise<unknown>;
     hasMore: boolean;
     isLoadingMore: boolean;
     refetch: () => Promise<unknown>;
 };
+declare function useSuspenseContent<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, const TFields extends readonly string[] = readonly string[]>(typeSlug: TSlug & string, options: UseContentOptions<"content", TFields> & {
+    view: "content";
+    fields: TFields;
+}): SuspenseContentResult<TMap[TSlug], "content", TFields>;
+declare function useSuspenseContent<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, options: UseContentOptions<"content"> & {
+    view: "content";
+    fields?: undefined;
+}): SuspenseContentResult<TMap[TSlug], "content">;
+declare function useSuspenseContent<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined>(typeSlug: TSlug & string, options?: UseContentOptions<TView, TFields>): SuspenseContentResult<TMap[TSlug], TView, TFields>;
 /**
  * Hook for fetching a single content item by ID with optional type safety.
  *
@@ -112,22 +130,40 @@ declare function useSuspenseContent<TMap extends Record<string, Record<string, u
  * // item?.parsedData.name is string
  * ```
  */
-declare function useContentItem<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string): {
-    item: SerializedContentItemWithType<TMap[TSlug]> | null;
+type ContentItemQueryResult<TData, TView extends CMSReadView, TFields extends CMSContentFields = undefined> = {
+    item: CMSContentItemResult<TData, TView, TFields> | null;
     isLoading: boolean;
     error: Error | null;
     refetch: () => void;
 };
+declare function useContentItem<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, const TFields extends readonly string[] = readonly string[]>(typeSlug: TSlug & string, id: string, options: CMSReadOptions<"content", TFields> & {
+    view: "content";
+    fields: TFields;
+}): ContentItemQueryResult<TMap[TSlug], "content", TFields>;
+declare function useContentItem<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string, options: CMSReadOptions<"content"> & {
+    view: "content";
+    fields?: undefined;
+}): ContentItemQueryResult<TMap[TSlug], "content">;
+declare function useContentItem<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined>(typeSlug: TSlug & string, id: string, options?: CMSReadOptions<TView, TFields>): ContentItemQueryResult<TMap[TSlug], TView, TFields>;
 /**
  * Suspense variant of useContentItem with optional type safety.
  *
  * @template TMap - A type map of content type slugs to their data types
  * @template TSlug - The content type slug (inferred from typeSlug parameter)
  */
-declare function useSuspenseContentItem<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string): {
-    item: SerializedContentItemWithType<TMap[TSlug]> | null;
+type SuspenseContentItemResult<TData, TView extends CMSReadView, TFields extends CMSContentFields = undefined> = {
+    item: CMSContentItemResult<TData, TView, TFields> | null;
     refetch: () => Promise<unknown>;
 };
+declare function useSuspenseContentItem<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, const TFields extends readonly string[] = readonly string[]>(typeSlug: TSlug & string, id: string, options: CMSReadOptions<"content", TFields> & {
+    view: "content";
+    fields: TFields;
+}): SuspenseContentItemResult<TMap[TSlug], "content", TFields>;
+declare function useSuspenseContentItem<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string, options: CMSReadOptions<"content"> & {
+    view: "content";
+    fields?: undefined;
+}): SuspenseContentItemResult<TMap[TSlug], "content">;
+declare function useSuspenseContentItem<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined>(typeSlug: TSlug & string, id: string, options?: CMSReadOptions<TView, TFields>): SuspenseContentItemResult<TMap[TSlug], TView, TFields>;
 /**
  * Hook for fetching a content item by slug with optional type safety.
  *
@@ -141,12 +177,15 @@ declare function useSuspenseContentItem<TMap extends Record<string, Record<strin
  * // item?.parsedData.price is number
  * ```
  */
-declare function useContentItemBySlug<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, slug: string): {
-    item: SerializedContentItemWithType<TMap[TSlug]> | null;
-    isLoading: boolean;
-    error: Error | null;
-    refetch: () => void;
-};
+declare function useContentItemBySlug<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, const TFields extends readonly string[] = readonly string[]>(typeSlug: TSlug & string, slug: string, options: CMSReadOptions<"content", TFields> & {
+    view: "content";
+    fields: TFields;
+}): ContentItemQueryResult<TMap[TSlug], "content", TFields>;
+declare function useContentItemBySlug<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, slug: string, options: CMSReadOptions<"content"> & {
+    view: "content";
+    fields?: undefined;
+}): ContentItemQueryResult<TMap[TSlug], "content">;
+declare function useContentItemBySlug<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined>(typeSlug: TSlug & string, slug: string, options?: CMSReadOptions<TView, TFields>): ContentItemQueryResult<TMap[TSlug], TView, TFields>;
 /**
  * Hook for creating a content item with optional type safety.
  *
@@ -527,15 +566,16 @@ declare function useContentItemForm<TValues>(config: ResourceFormConfig<TValues,
  * query, with selected ids missing from the current results preloaded via
  * the `detail` query (typeSlug, id) so their labels resolve.
  *
- * Used by the relation picker (`RelationField`).
+ * Used by the relation picker (`RelationField`). Optional content view/fields
+ * apply to both search results and selected-ID preloads; full records remain the default.
  */
-declare function useContentOptions(config: {
-    /** Content type slug to search within */
+declare function useContentOptions<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(config: {
+    /** Content type slug to search within. */
     targetType: string;
-    /** Currently selected item ids — preloaded when missing from options */
+    /** Currently selected IDs, preloaded when absent from search results. */
     value: string[];
-    getOptionLabel: (item: SerializedContentItemWithType) => string;
-}): ResourceSelectResult<SerializedContentItemWithType>;
+    getOptionLabel: (item: CMSContentItemResult<Record<string, unknown>, TView, TFields>) => string;
+} & CMSReadOptions<TView, TFields>): ResourceSelectResult<CMSContentItemResult<Record<string, unknown>, TView, TFields>>;
 /**
  * Content item with populated relations
  */
@@ -575,7 +615,7 @@ declare function useSuspenseContentItemPopulated<TMap extends Record<string, Rec
 /**
  * Options for useContentByRelation hook
  */
-interface UseContentByRelationOptions {
+interface UseContentByRelationOptions<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> extends CMSReadOptions<TView, TFields> {
     /** Number of items per page (default: 20) */
     limit?: number;
     /** Whether to enable the query (default: true) */
@@ -594,27 +634,27 @@ interface UseContentByRelationOptions {
  * const { items } = useContentByRelation("resource", "categoryIds", categoryId)
  * ```
  */
-declare function useContentByRelation<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, fieldName: string, targetId: string, options?: UseContentByRelationOptions): {
-    items: SerializedContentItemWithType<TMap[TSlug]>[];
-    total: number;
-    isLoading: boolean;
-    error: Error | null;
-    loadMore: () => void;
-    hasMore: boolean;
-    isLoadingMore: boolean;
-    refetch: () => void;
-};
+declare function useContentByRelation<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, const TFields extends readonly string[] = readonly string[]>(typeSlug: TSlug & string, fieldName: string, targetId: string, options: UseContentByRelationOptions<"content", TFields> & {
+    view: "content";
+    fields: TFields;
+}): UseContentResult<TMap[TSlug], "content", TFields>;
+declare function useContentByRelation<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, fieldName: string, targetId: string, options: UseContentByRelationOptions<"content"> & {
+    view: "content";
+    fields?: undefined;
+}): UseContentResult<TMap[TSlug], "content">;
+declare function useContentByRelation<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined>(typeSlug: TSlug & string, fieldName: string, targetId: string, options?: UseContentByRelationOptions<TView, TFields>): UseContentResult<TMap[TSlug], TView, TFields>;
 /**
  * Suspense variant of useContentByRelation
  */
-declare function useSuspenseContentByRelation<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, fieldName: string, targetId: string, options?: UseContentByRelationOptions): {
-    items: SerializedContentItemWithType<TMap[TSlug]>[];
-    total: number;
-    loadMore: () => Promise<unknown>;
-    hasMore: boolean;
-    isLoadingMore: boolean;
-    refetch: () => Promise<unknown>;
-};
+declare function useSuspenseContentByRelation<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, const TFields extends readonly string[] = readonly string[]>(typeSlug: TSlug & string, fieldName: string, targetId: string, options: UseContentByRelationOptions<"content", TFields> & {
+    view: "content";
+    fields: TFields;
+}): SuspenseContentResult<TMap[TSlug], "content", TFields>;
+declare function useSuspenseContentByRelation<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, fieldName: string, targetId: string, options: UseContentByRelationOptions<"content"> & {
+    view: "content";
+    fields?: undefined;
+}): SuspenseContentResult<TMap[TSlug], "content">;
+declare function useSuspenseContentByRelation<TMap extends CMSContentTypeMap = CMSContentTypeMap, TSlug extends keyof TMap = keyof TMap, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined>(typeSlug: TSlug & string, fieldName: string, targetId: string, options?: UseContentByRelationOptions<TView, TFields>): SuspenseContentResult<TMap[TSlug], TView, TFields>;
 /**
  * Hook for fetching the inverse relations of a content item — the content
  * types with belongsTo fields pointing at it, with per-field counts.
@@ -629,15 +669,20 @@ declare function useInverseRelations(contentTypeSlug: string, itemId: string): {
  * Hook for listing the items behind one inverse relation (e.g. all comments
  * whose `resourceId` points at this resource).
  */
-declare function useInverseRelationItems(params: {
+declare function useInverseRelationItems<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(params: {
     contentTypeSlug: string;
     sourceType: string;
     itemId: string;
     fieldName: string;
-}, options?: {
+}, options?: CMSReadOptions<TView, TFields> & {
+    /** Whether to enable the query (default: true). */
     enabled?: boolean;
+    /** Number of items per page (default: 20). */
+    limit?: number;
+    /** Number of matching items to skip (default: 0). */
+    offset?: number;
 }): {
-    items: SerializedContentItemWithType[];
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
     total: number;
     isLoading: boolean;
     error: Error | null;