@btst/stack 1.8.0 → 1.9.1

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

@@ -3,7 +3,7 @@ import * as react from 'react';
 import { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { P as Post, S as SerializedPost } from '../../../shared/stack.DLhzx1-D.mjs';
+import { P as Post, S as SerializedPost } from '../../../shared/stack.CcI4sYJP.mjs';
 export { UsePostsOptions, UsePostsResult } from './hooks/index.mjs';
 import 'zod';
 

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

@@ -3,7 +3,7 @@ import * as react from 'react';
 import { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { P as Post, S as SerializedPost } from '../../../shared/stack.DLhzx1-D.js';
+import { P as Post, S as SerializedPost } from '../../../shared/stack.CcI4sYJP.js';
 export { UsePostsOptions, UsePostsResult } from './hooks/index.js';
 import 'zod';
 

package/dist/plugins/blog/query-keys.d.cts

@@ -1,7 +1,7 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
 import { z } from 'zod';
-import { c as createPostSchema, u as updatePostSchema, P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../shared/stack.DLhzx1-D.cjs';
+import { c as createPostSchema, u as updatePostSchema, P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../shared/stack.CcI4sYJP.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
 
@@ -144,10 +144,10 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
     readonly createPost: better_call.StrictEndpoint<"/posts", {
         method: "POST";
         body: z.ZodObject<{
-            title: z.ZodString;
             slug: z.ZodOptional<z.ZodString>;
             published: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+            title: z.ZodString;
             content: z.ZodString;
             excerpt: z.ZodString;
             image: z.ZodOptional<z.ZodString>;

package/dist/plugins/blog/query-keys.d.mts

@@ -1,7 +1,7 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
 import { z } from 'zod';
-import { c as createPostSchema, u as updatePostSchema, P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../shared/stack.DLhzx1-D.mjs';
+import { c as createPostSchema, u as updatePostSchema, P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../shared/stack.CcI4sYJP.mjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
 
@@ -144,10 +144,10 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
     readonly createPost: better_call.StrictEndpoint<"/posts", {
         method: "POST";
         body: z.ZodObject<{
-            title: z.ZodString;
             slug: z.ZodOptional<z.ZodString>;
             published: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+            title: z.ZodString;
             content: z.ZodString;
             excerpt: z.ZodString;
             image: z.ZodOptional<z.ZodString>;

package/dist/plugins/blog/query-keys.d.ts

@@ -1,7 +1,7 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
 import { z } from 'zod';
-import { c as createPostSchema, u as updatePostSchema, P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../shared/stack.DLhzx1-D.js';
+import { c as createPostSchema, u as updatePostSchema, P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../shared/stack.CcI4sYJP.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
 
@@ -144,10 +144,10 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
     readonly createPost: better_call.StrictEndpoint<"/posts", {
         method: "POST";
         body: z.ZodObject<{
-            title: z.ZodString;
             slug: z.ZodOptional<z.ZodString>;
             published: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+            title: z.ZodString;
             content: z.ZodString;
             excerpt: z.ZodString;
             image: z.ZodOptional<z.ZodString>;

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

@@ -1,7 +1,7 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
 import { z } from 'zod';
-import { C as CMSBackendConfig, S as SerializedContentType, a as SerializedContentItemWithType } from '../../../shared/stack.L-UFwz2G.cjs';
+import { C as CMSBackendConfig, S as SerializedContentType, a as SerializedContentItemWithType, I as InverseRelation } from '../../../shared/stack.oGOteE6g.cjs';
 
 /**
  * CMS backend plugin
@@ -63,7 +63,7 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
             data: z.ZodObject<{}, z.core.$loose>;
         }, z.core.$strip>;
     }, {
-        parsedData: unknown;
+        parsedData: Record<string, unknown>;
         createdAt: string;
         updatedAt: string;
         id: string;
@@ -92,6 +92,70 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
     }, {
         success: boolean;
     }>;
+    getContentItemPopulated: better_call.StrictEndpoint<"/content/:typeSlug/:id/populated", {
+        method: "GET";
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strip>;
+    }, {
+        _relations: Record<string, SerializedContentItemWithType<Record<string, unknown>>[]>;
+        parsedData: Record<string, unknown>;
+        contentType?: SerializedContentType;
+        createdAt: string;
+        updatedAt: string;
+        id: string;
+        slug: string;
+        contentTypeId: string;
+        data: string;
+        authorId?: string | undefined;
+    }>;
+    listContentByRelation: better_call.StrictEndpoint<"/content/:typeSlug/by-relation", {
+        method: "GET";
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            field: z.ZodString;
+            targetId: z.ZodString;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        }, z.core.$strip>;
+    }, {
+        items: SerializedContentItemWithType<Record<string, unknown>>[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    getInverseRelations: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations", {
+        method: "GET";
+        params: z.ZodObject<{
+            slug: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            itemId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, {
+        inverseRelations: InverseRelation[];
+    }>;
+    listInverseRelationItems: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations/:sourceType", {
+        method: "GET";
+        params: z.ZodObject<{
+            slug: z.ZodString;
+            sourceType: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            itemId: z.ZodString;
+            fieldName: z.ZodString;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        }, z.core.$strip>;
+    }, {
+        items: SerializedContentItemWithType<Record<string, unknown>>[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
 }>;
 type CMSApiRouter = ReturnType<ReturnType<typeof cmsBackendPlugin>["routes"]>;
 

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

@@ -1,7 +1,7 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
 import { z } from 'zod';
-import { C as CMSBackendConfig, S as SerializedContentType, a as SerializedContentItemWithType } from '../../../shared/stack.L-UFwz2G.mjs';
+import { C as CMSBackendConfig, S as SerializedContentType, a as SerializedContentItemWithType, I as InverseRelation } from '../../../shared/stack.oGOteE6g.mjs';
 
 /**
  * CMS backend plugin
@@ -63,7 +63,7 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
             data: z.ZodObject<{}, z.core.$loose>;
         }, z.core.$strip>;
     }, {
-        parsedData: unknown;
+        parsedData: Record<string, unknown>;
         createdAt: string;
         updatedAt: string;
         id: string;
@@ -92,6 +92,70 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
     }, {
         success: boolean;
     }>;
+    getContentItemPopulated: better_call.StrictEndpoint<"/content/:typeSlug/:id/populated", {
+        method: "GET";
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strip>;
+    }, {
+        _relations: Record<string, SerializedContentItemWithType<Record<string, unknown>>[]>;
+        parsedData: Record<string, unknown>;
+        contentType?: SerializedContentType;
+        createdAt: string;
+        updatedAt: string;
+        id: string;
+        slug: string;
+        contentTypeId: string;
+        data: string;
+        authorId?: string | undefined;
+    }>;
+    listContentByRelation: better_call.StrictEndpoint<"/content/:typeSlug/by-relation", {
+        method: "GET";
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            field: z.ZodString;
+            targetId: z.ZodString;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        }, z.core.$strip>;
+    }, {
+        items: SerializedContentItemWithType<Record<string, unknown>>[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    getInverseRelations: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations", {
+        method: "GET";
+        params: z.ZodObject<{
+            slug: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            itemId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, {
+        inverseRelations: InverseRelation[];
+    }>;
+    listInverseRelationItems: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations/:sourceType", {
+        method: "GET";
+        params: z.ZodObject<{
+            slug: z.ZodString;
+            sourceType: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            itemId: z.ZodString;
+            fieldName: z.ZodString;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        }, z.core.$strip>;
+    }, {
+        items: SerializedContentItemWithType<Record<string, unknown>>[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
 }>;
 type CMSApiRouter = ReturnType<ReturnType<typeof cmsBackendPlugin>["routes"]>;
 

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

@@ -1,7 +1,7 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
 import { z } from 'zod';
-import { C as CMSBackendConfig, S as SerializedContentType, a as SerializedContentItemWithType } from '../../../shared/stack.L-UFwz2G.js';
+import { C as CMSBackendConfig, S as SerializedContentType, a as SerializedContentItemWithType, I as InverseRelation } from '../../../shared/stack.oGOteE6g.js';
 
 /**
  * CMS backend plugin
@@ -63,7 +63,7 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
             data: z.ZodObject<{}, z.core.$loose>;
         }, z.core.$strip>;
     }, {
-        parsedData: unknown;
+        parsedData: Record<string, unknown>;
         createdAt: string;
         updatedAt: string;
         id: string;
@@ -92,6 +92,70 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
     }, {
         success: boolean;
     }>;
+    getContentItemPopulated: better_call.StrictEndpoint<"/content/:typeSlug/:id/populated", {
+        method: "GET";
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strip>;
+    }, {
+        _relations: Record<string, SerializedContentItemWithType<Record<string, unknown>>[]>;
+        parsedData: Record<string, unknown>;
+        contentType?: SerializedContentType;
+        createdAt: string;
+        updatedAt: string;
+        id: string;
+        slug: string;
+        contentTypeId: string;
+        data: string;
+        authorId?: string | undefined;
+    }>;
+    listContentByRelation: better_call.StrictEndpoint<"/content/:typeSlug/by-relation", {
+        method: "GET";
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            field: z.ZodString;
+            targetId: z.ZodString;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        }, z.core.$strip>;
+    }, {
+        items: SerializedContentItemWithType<Record<string, unknown>>[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    getInverseRelations: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations", {
+        method: "GET";
+        params: z.ZodObject<{
+            slug: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            itemId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, {
+        inverseRelations: InverseRelation[];
+    }>;
+    listInverseRelationItems: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations/:sourceType", {
+        method: "GET";
+        params: z.ZodObject<{
+            slug: z.ZodString;
+            sourceType: z.ZodString;
+        }, z.core.$strip>;
+        query: z.ZodObject<{
+            itemId: z.ZodString;
+            fieldName: z.ZodString;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        }, z.core.$strip>;
+    }, {
+        items: SerializedContentItemWithType<Record<string, unknown>>[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
 }>;
 type CMSApiRouter = ReturnType<ReturnType<typeof cmsBackendPlugin>["routes"]>;
 

package/dist/plugins/cms/client/hooks/index.cjs

@@ -5,13 +5,17 @@ const cmsHooks = require('../../../../packages/better-stack/src/plugins/cms/clie
 
 
 exports.useContent = cmsHooks.useContent;
+exports.useContentByRelation = cmsHooks.useContentByRelation;
 exports.useContentItem = cmsHooks.useContentItem;
 exports.useContentItemBySlug = cmsHooks.useContentItemBySlug;
+exports.useContentItemPopulated = cmsHooks.useContentItemPopulated;
 exports.useContentType = cmsHooks.useContentType;
 exports.useContentTypes = cmsHooks.useContentTypes;
 exports.useCreateContent = cmsHooks.useCreateContent;
 exports.useDeleteContent = cmsHooks.useDeleteContent;
 exports.useSuspenseContent = cmsHooks.useSuspenseContent;
+exports.useSuspenseContentByRelation = cmsHooks.useSuspenseContentByRelation;
 exports.useSuspenseContentItem = cmsHooks.useSuspenseContentItem;
+exports.useSuspenseContentItemPopulated = cmsHooks.useSuspenseContentItemPopulated;
 exports.useSuspenseContentTypes = cmsHooks.useSuspenseContentTypes;
 exports.useUpdateContent = cmsHooks.useUpdateContent;

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

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedContentType, a as SerializedContentItemWithType } from '../../../../shared/stack.L-UFwz2G.cjs';
+import { S as SerializedContentType, a as SerializedContentItemWithType } from '../../../../shared/stack.oGOteE6g.cjs';
 import 'zod';
 
 interface UseContentTypesResult {
@@ -195,6 +195,85 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
 declare function useDeleteContent(typeSlug: string): _tanstack_react_query.UseMutationResult<{
     success: boolean;
 }, Error, string, unknown>;
+/**
+ * Content item with populated relations
+ */
+interface ContentItemWithRelations<TData = Record<string, unknown>> extends SerializedContentItemWithType<TData> {
+    _relations?: Record<string, SerializedContentItemWithType[]>;
+}
+/**
+ * Hook for fetching a content item with its relations populated.
+ * Use this when you need to display related items alongside the main item.
+ *
+ * @template TMap - A type map of content type slugs to their data types
+ * @template TSlug - The content type slug (inferred from typeSlug parameter)
+ *
+ * @example
+ * ```typescript
+ * type MyCMSTypes = {
+ *   resource: { name: string; categoryIds: Array<{ id: string }> }
+ *   category: { name: string }
+ * }
+ * const { item } = useContentItemPopulated<MyCMSTypes, "resource">("resource", "some-id")
+ * // item?._relations?.categoryIds contains populated category items
+ * ```
+ */
+declare function useContentItemPopulated<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string): {
+    item: ContentItemWithRelations<TMap[TSlug]> | null;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+/**
+ * Suspense variant of useContentItemPopulated
+ */
+declare function useSuspenseContentItemPopulated<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string): {
+    item: ContentItemWithRelations<TMap[TSlug]> | null;
+    refetch: () => Promise<unknown>;
+};
+/**
+ * Options for useContentByRelation hook
+ */
+interface UseContentByRelationOptions {
+    /** Number of items per page (default: 20) */
+    limit?: number;
+    /** Whether to enable the query (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Hook for fetching content items that have a specific relation.
+ * Useful for "filter by category" functionality.
+ *
+ * @template TMap - A type map of content type slugs to their data types
+ * @template TSlug - The content type slug (inferred from typeSlug parameter)
+ *
+ * @example
+ * ```typescript
+ * // Get all resources in a specific category
+ * 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;
+};
+/**
+ * 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>;
+};
 
-export { useContent, useContentItem, useContentItemBySlug, useContentType, useContentTypes, useCreateContent, useDeleteContent, useSuspenseContent, useSuspenseContentItem, useSuspenseContentTypes, useUpdateContent };
-export type { UseContentOptions, UseContentResult, UseContentTypesResult };
+export { useContent, useContentByRelation, useContentItem, useContentItemBySlug, useContentItemPopulated, useContentType, useContentTypes, useCreateContent, useDeleteContent, useSuspenseContent, useSuspenseContentByRelation, useSuspenseContentItem, useSuspenseContentItemPopulated, useSuspenseContentTypes, useUpdateContent };
+export type { ContentItemWithRelations, UseContentByRelationOptions, UseContentOptions, UseContentResult, UseContentTypesResult };

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

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedContentType, a as SerializedContentItemWithType } from '../../../../shared/stack.L-UFwz2G.mjs';
+import { S as SerializedContentType, a as SerializedContentItemWithType } from '../../../../shared/stack.oGOteE6g.mjs';
 import 'zod';
 
 interface UseContentTypesResult {
@@ -195,6 +195,85 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
 declare function useDeleteContent(typeSlug: string): _tanstack_react_query.UseMutationResult<{
     success: boolean;
 }, Error, string, unknown>;
+/**
+ * Content item with populated relations
+ */
+interface ContentItemWithRelations<TData = Record<string, unknown>> extends SerializedContentItemWithType<TData> {
+    _relations?: Record<string, SerializedContentItemWithType[]>;
+}
+/**
+ * Hook for fetching a content item with its relations populated.
+ * Use this when you need to display related items alongside the main item.
+ *
+ * @template TMap - A type map of content type slugs to their data types
+ * @template TSlug - The content type slug (inferred from typeSlug parameter)
+ *
+ * @example
+ * ```typescript
+ * type MyCMSTypes = {
+ *   resource: { name: string; categoryIds: Array<{ id: string }> }
+ *   category: { name: string }
+ * }
+ * const { item } = useContentItemPopulated<MyCMSTypes, "resource">("resource", "some-id")
+ * // item?._relations?.categoryIds contains populated category items
+ * ```
+ */
+declare function useContentItemPopulated<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string): {
+    item: ContentItemWithRelations<TMap[TSlug]> | null;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+/**
+ * Suspense variant of useContentItemPopulated
+ */
+declare function useSuspenseContentItemPopulated<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string): {
+    item: ContentItemWithRelations<TMap[TSlug]> | null;
+    refetch: () => Promise<unknown>;
+};
+/**
+ * Options for useContentByRelation hook
+ */
+interface UseContentByRelationOptions {
+    /** Number of items per page (default: 20) */
+    limit?: number;
+    /** Whether to enable the query (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Hook for fetching content items that have a specific relation.
+ * Useful for "filter by category" functionality.
+ *
+ * @template TMap - A type map of content type slugs to their data types
+ * @template TSlug - The content type slug (inferred from typeSlug parameter)
+ *
+ * @example
+ * ```typescript
+ * // Get all resources in a specific category
+ * 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;
+};
+/**
+ * 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>;
+};
 
-export { useContent, useContentItem, useContentItemBySlug, useContentType, useContentTypes, useCreateContent, useDeleteContent, useSuspenseContent, useSuspenseContentItem, useSuspenseContentTypes, useUpdateContent };
-export type { UseContentOptions, UseContentResult, UseContentTypesResult };
+export { useContent, useContentByRelation, useContentItem, useContentItemBySlug, useContentItemPopulated, useContentType, useContentTypes, useCreateContent, useDeleteContent, useSuspenseContent, useSuspenseContentByRelation, useSuspenseContentItem, useSuspenseContentItemPopulated, useSuspenseContentTypes, useUpdateContent };
+export type { ContentItemWithRelations, UseContentByRelationOptions, UseContentOptions, UseContentResult, UseContentTypesResult };

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

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedContentType, a as SerializedContentItemWithType } from '../../../../shared/stack.L-UFwz2G.js';
+import { S as SerializedContentType, a as SerializedContentItemWithType } from '../../../../shared/stack.oGOteE6g.js';
 import 'zod';
 
 interface UseContentTypesResult {
@@ -195,6 +195,85 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
 declare function useDeleteContent(typeSlug: string): _tanstack_react_query.UseMutationResult<{
     success: boolean;
 }, Error, string, unknown>;
+/**
+ * Content item with populated relations
+ */
+interface ContentItemWithRelations<TData = Record<string, unknown>> extends SerializedContentItemWithType<TData> {
+    _relations?: Record<string, SerializedContentItemWithType[]>;
+}
+/**
+ * Hook for fetching a content item with its relations populated.
+ * Use this when you need to display related items alongside the main item.
+ *
+ * @template TMap - A type map of content type slugs to their data types
+ * @template TSlug - The content type slug (inferred from typeSlug parameter)
+ *
+ * @example
+ * ```typescript
+ * type MyCMSTypes = {
+ *   resource: { name: string; categoryIds: Array<{ id: string }> }
+ *   category: { name: string }
+ * }
+ * const { item } = useContentItemPopulated<MyCMSTypes, "resource">("resource", "some-id")
+ * // item?._relations?.categoryIds contains populated category items
+ * ```
+ */
+declare function useContentItemPopulated<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string): {
+    item: ContentItemWithRelations<TMap[TSlug]> | null;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+/**
+ * Suspense variant of useContentItemPopulated
+ */
+declare function useSuspenseContentItemPopulated<TMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TSlug extends keyof TMap = keyof TMap>(typeSlug: TSlug & string, id: string): {
+    item: ContentItemWithRelations<TMap[TSlug]> | null;
+    refetch: () => Promise<unknown>;
+};
+/**
+ * Options for useContentByRelation hook
+ */
+interface UseContentByRelationOptions {
+    /** Number of items per page (default: 20) */
+    limit?: number;
+    /** Whether to enable the query (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Hook for fetching content items that have a specific relation.
+ * Useful for "filter by category" functionality.
+ *
+ * @template TMap - A type map of content type slugs to their data types
+ * @template TSlug - The content type slug (inferred from typeSlug parameter)
+ *
+ * @example
+ * ```typescript
+ * // Get all resources in a specific category
+ * 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;
+};
+/**
+ * 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>;
+};
 
-export { useContent, useContentItem, useContentItemBySlug, useContentType, useContentTypes, useCreateContent, useDeleteContent, useSuspenseContent, useSuspenseContentItem, useSuspenseContentTypes, useUpdateContent };
-export type { UseContentOptions, UseContentResult, UseContentTypesResult };
+export { useContent, useContentByRelation, useContentItem, useContentItemBySlug, useContentItemPopulated, useContentType, useContentTypes, useCreateContent, useDeleteContent, useSuspenseContent, useSuspenseContentByRelation, useSuspenseContentItem, useSuspenseContentItemPopulated, useSuspenseContentTypes, useUpdateContent };
+export type { ContentItemWithRelations, UseContentByRelationOptions, UseContentOptions, UseContentResult, UseContentTypesResult };

package/dist/plugins/cms/client/hooks/index.mjs

@@ -1 +1 @@
-export { useContent, useContentItem, useContentItemBySlug, useContentType, useContentTypes, useCreateContent, useDeleteContent, useSuspenseContent, useSuspenseContentItem, useSuspenseContentTypes, useUpdateContent } from '../../../../packages/better-stack/src/plugins/cms/client/hooks/cms-hooks.mjs';
+export { useContent, useContentByRelation, useContentItem, useContentItemBySlug, useContentItemPopulated, useContentType, useContentTypes, useCreateContent, useDeleteContent, useSuspenseContent, useSuspenseContentByRelation, useSuspenseContentItem, useSuspenseContentItemPopulated, useSuspenseContentTypes, useUpdateContent } from '../../../../packages/better-stack/src/plugins/cms/client/hooks/cms-hooks.mjs';