@btst/stack 2.11.2 → 2.11.4

package/dist/shared/{stack.E17kSK1W.d.mts → stack.C1jLzFZ6.d.mts}

@@ -1,7 +1,7 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BWp0hcm9.mjs';
+import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BQmuNl5p.mjs';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DBAdapter } from '@btst/db';
 import * as better_call from 'better-call';
@@ -324,11 +324,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
+            publishedAt?: unknown;
             image?: string | undefined;
+            published?: boolean | undefined;
         }, {
             title: string;
             content: string;
@@ -341,11 +341,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
+            publishedAt?: unknown;
             image?: string | undefined;
+            published?: boolean | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {

package/dist/shared/{stack.D0p6oNme.d.ts → stack.DF1ewpVE.d.ts}

@@ -1,7 +1,7 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BWp0hcm9.js';
+import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BQmuNl5p.js';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DBAdapter } from '@btst/db';
 import * as better_call from 'better-call';
@@ -324,11 +324,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
+            publishedAt?: unknown;
             image?: string | undefined;
+            published?: boolean | undefined;
         }, {
             title: string;
             content: string;
@@ -341,11 +341,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
+            publishedAt?: unknown;
             image?: string | undefined;
+            published?: boolean | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {

package/dist/shared/{stack.BX7MHi0J.d.mts → stack.DbnCLdNF.d.mts}

@@ -87,12 +87,36 @@ interface CreateCMSContentItemInput {
     /** Arbitrary data payload — should match the content type schema */
     data: Record<string, unknown>;
 }
+/**
+ * Options for {@link createCMSContentItem}.
+ */
+interface CreateCMSContentItemOptions {
+    /**
+     * When `true`, persist relation fields (`belongsTo`, `hasMany`,
+     * `manyToMany`) into the `contentRelation` junction table in addition to
+     * the item's JSON payload.
+     *
+     * This is what the HTTP `POST /content/:typeSlug` route does, and is
+     * required for the admin "Related Items" panel / inverse-relation queries
+     * to find the item.
+     *
+     * Seeds and other programmatic callers that want the admin UI to work
+     * should enable this flag. Callers are still expected to pass
+     * pre-created target IDs (`{ id }` or `[{ id }, ...]`) — inline `_new`
+     * creation is only supported via the HTTP route.
+     *
+     * Defaults to `false` for backwards compatibility (a no-op for content
+     * types without relations).
+     */
+    syncRelations?: boolean;
+}
 /**
  * Create a new content item for a content type (looked up by slug).
  *
- * Bypasses Zod schema validation and relation processing — the caller is
- * responsible for providing valid, relation-free data. For relation fields or
- * schema validation, use the HTTP endpoint instead.
+ * Bypasses Zod schema validation and inline `_new` relation creation — the
+ * caller is responsible for providing valid data and pre-created relation
+ * IDs. For schema validation or inline creation of related items, use the
+ * HTTP endpoint instead.
  *
  * Throws if the content type is not found or the slug is already taken within
  * that content type.
@@ -104,8 +128,11 @@ interface CreateCMSContentItemInput {
  * @param adapter - The database adapter
  * @param contentTypeSlug - Slug of the target content type
  * @param input - Item slug and data payload
+ * @param options - See {@link CreateCMSContentItemOptions}. Pass
+ *   `{ syncRelations: true }` to also populate the `contentRelation`
+ *   junction table for relation fields in the payload.
  */
-declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput): Promise<SerializedContentItem>;
+declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
 
 /**
  * Route keys for the CMS plugin — matches the keys returned by
@@ -331,7 +358,7 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
     getContentItemBySlug: (contentTypeSlug: string, slug: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     getContentItemById: (id: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     prefetchForRoute: CMSPrefetchForRoute;
-    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2]) => Promise<SerializedContentItem>;
+    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2], options?: Parameters<typeof createCMSContentItem>[3]) => Promise<SerializedContentItem>;
 }>;
 type CMSApiRouter = ReturnType<ReturnType<typeof cmsBackendPlugin>["routes"]>;
 
@@ -368,5 +395,5 @@ declare const CMS_QUERY_KEYS: {
     contentDetail: (typeSlug: string, id: string) => readonly ["cmsContent", "detail", string, string];
 };
 
-export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as l, serializeContentType as s };
-export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k };
+export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as m, serializeContentType as s };
+export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k, CreateCMSContentItemOptions as l };

package/dist/shared/{stack.VF6FhyZw.d.ts → stack.QYn-Px94.d.ts}

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.BWp0hcm9.js';
+import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.BQmuNl5p.js';
 import { z } from 'zod';
 
 /**
@@ -135,14 +135,14 @@ declare function useCreatePost(): _tanstack_react_query.UseMutationResult<Serial
         name: string;
         slug: string;
     })[];
-    published: boolean;
     title: string;
     content: string;
     excerpt: string;
+    published: boolean;
     slug?: string | undefined;
-    publishedAt?: Date | undefined;
     createdAt?: Date | undefined;
     updatedAt?: Date | undefined;
+    publishedAt?: Date | undefined;
     image?: string | undefined;
 }, unknown>;
 /** Update an existing post by id */

package/dist/shared/{stack.DWipT53I.d.cts → stack.XulPeAD3.d.cts}

@@ -1,7 +1,7 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BWp0hcm9.cjs';
+import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BQmuNl5p.cjs';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DBAdapter } from '@btst/db';
 import * as better_call from 'better-call';
@@ -324,11 +324,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
+            publishedAt?: unknown;
             image?: string | undefined;
+            published?: boolean | undefined;
         }, {
             title: string;
             content: string;
@@ -341,11 +341,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
+            publishedAt?: unknown;
             image?: string | undefined;
+            published?: boolean | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {

package/dist/shared/{stack.fQjVhw5a.d.ts → stack.fXlShnhv.d.ts}

@@ -87,12 +87,36 @@ interface CreateCMSContentItemInput {
     /** Arbitrary data payload — should match the content type schema */
     data: Record<string, unknown>;
 }
+/**
+ * Options for {@link createCMSContentItem}.
+ */
+interface CreateCMSContentItemOptions {
+    /**
+     * When `true`, persist relation fields (`belongsTo`, `hasMany`,
+     * `manyToMany`) into the `contentRelation` junction table in addition to
+     * the item's JSON payload.
+     *
+     * This is what the HTTP `POST /content/:typeSlug` route does, and is
+     * required for the admin "Related Items" panel / inverse-relation queries
+     * to find the item.
+     *
+     * Seeds and other programmatic callers that want the admin UI to work
+     * should enable this flag. Callers are still expected to pass
+     * pre-created target IDs (`{ id }` or `[{ id }, ...]`) — inline `_new`
+     * creation is only supported via the HTTP route.
+     *
+     * Defaults to `false` for backwards compatibility (a no-op for content
+     * types without relations).
+     */
+    syncRelations?: boolean;
+}
 /**
  * Create a new content item for a content type (looked up by slug).
  *
- * Bypasses Zod schema validation and relation processing — the caller is
- * responsible for providing valid, relation-free data. For relation fields or
- * schema validation, use the HTTP endpoint instead.
+ * Bypasses Zod schema validation and inline `_new` relation creation — the
+ * caller is responsible for providing valid data and pre-created relation
+ * IDs. For schema validation or inline creation of related items, use the
+ * HTTP endpoint instead.
  *
  * Throws if the content type is not found or the slug is already taken within
  * that content type.
@@ -104,8 +128,11 @@ interface CreateCMSContentItemInput {
  * @param adapter - The database adapter
  * @param contentTypeSlug - Slug of the target content type
  * @param input - Item slug and data payload
+ * @param options - See {@link CreateCMSContentItemOptions}. Pass
+ *   `{ syncRelations: true }` to also populate the `contentRelation`
+ *   junction table for relation fields in the payload.
  */
-declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput): Promise<SerializedContentItem>;
+declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
 
 /**
  * Route keys for the CMS plugin — matches the keys returned by
@@ -331,7 +358,7 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
     getContentItemBySlug: (contentTypeSlug: string, slug: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     getContentItemById: (id: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     prefetchForRoute: CMSPrefetchForRoute;
-    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2]) => Promise<SerializedContentItem>;
+    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2], options?: Parameters<typeof createCMSContentItem>[3]) => Promise<SerializedContentItem>;
 }>;
 type CMSApiRouter = ReturnType<ReturnType<typeof cmsBackendPlugin>["routes"]>;
 
@@ -368,5 +395,5 @@ declare const CMS_QUERY_KEYS: {
     contentDetail: (typeSlug: string, id: string) => readonly ["cmsContent", "detail", string, string];
 };
 
-export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as l, serializeContentType as s };
-export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k };
+export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as m, serializeContentType as s };
+export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k, CreateCMSContentItemOptions as l };

package/dist/shared/{stack.C9zoS1TN.d.cts → stack.r6HohbyX.d.cts}

@@ -87,12 +87,36 @@ interface CreateCMSContentItemInput {
     /** Arbitrary data payload — should match the content type schema */
     data: Record<string, unknown>;
 }
+/**
+ * Options for {@link createCMSContentItem}.
+ */
+interface CreateCMSContentItemOptions {
+    /**
+     * When `true`, persist relation fields (`belongsTo`, `hasMany`,
+     * `manyToMany`) into the `contentRelation` junction table in addition to
+     * the item's JSON payload.
+     *
+     * This is what the HTTP `POST /content/:typeSlug` route does, and is
+     * required for the admin "Related Items" panel / inverse-relation queries
+     * to find the item.
+     *
+     * Seeds and other programmatic callers that want the admin UI to work
+     * should enable this flag. Callers are still expected to pass
+     * pre-created target IDs (`{ id }` or `[{ id }, ...]`) — inline `_new`
+     * creation is only supported via the HTTP route.
+     *
+     * Defaults to `false` for backwards compatibility (a no-op for content
+     * types without relations).
+     */
+    syncRelations?: boolean;
+}
 /**
  * Create a new content item for a content type (looked up by slug).
  *
- * Bypasses Zod schema validation and relation processing — the caller is
- * responsible for providing valid, relation-free data. For relation fields or
- * schema validation, use the HTTP endpoint instead.
+ * Bypasses Zod schema validation and inline `_new` relation creation — the
+ * caller is responsible for providing valid data and pre-created relation
+ * IDs. For schema validation or inline creation of related items, use the
+ * HTTP endpoint instead.
  *
  * Throws if the content type is not found or the slug is already taken within
  * that content type.
@@ -104,8 +128,11 @@ interface CreateCMSContentItemInput {
  * @param adapter - The database adapter
  * @param contentTypeSlug - Slug of the target content type
  * @param input - Item slug and data payload
+ * @param options - See {@link CreateCMSContentItemOptions}. Pass
+ *   `{ syncRelations: true }` to also populate the `contentRelation`
+ *   junction table for relation fields in the payload.
  */
-declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput): Promise<SerializedContentItem>;
+declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
 
 /**
  * Route keys for the CMS plugin — matches the keys returned by
@@ -331,7 +358,7 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
     getContentItemBySlug: (contentTypeSlug: string, slug: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     getContentItemById: (id: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     prefetchForRoute: CMSPrefetchForRoute;
-    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2]) => Promise<SerializedContentItem>;
+    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2], options?: Parameters<typeof createCMSContentItem>[3]) => Promise<SerializedContentItem>;
 }>;
 type CMSApiRouter = ReturnType<ReturnType<typeof cmsBackendPlugin>["routes"]>;
 
@@ -368,5 +395,5 @@ declare const CMS_QUERY_KEYS: {
     contentDetail: (typeSlug: string, id: string) => readonly ["cmsContent", "detail", string, string];
 };
 
-export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as l, serializeContentType as s };
-export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k };
+export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as m, serializeContentType as s };
+export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k, CreateCMSContentItemOptions as l };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/stack",
-  "version": "2.11.2",
+  "version": "2.11.4",
   "description": "A composable, plugin-based library for building full-stack applications.",
   "repository": {
     "type": "git",
@@ -742,7 +742,7 @@
     }
   },
   "dependencies": {
-    "@btst/db": "2.1.1",
+    "@btst/db": "2.2.1",
     "@lukemorales/query-key-factory": "^1.3.4",
     "@milkdown/crepe": "^7.17.1",
     "@milkdown/kit": "^7.17.1",
@@ -763,7 +763,7 @@
     "@tanstack/react-query": "^5.0.0",
     "@vercel/blob": ">=0.14.0",
     "ai": ">=5.0.0",
-    "better-call": ">=1.3.2",
+    "better-call": ">=1.3.5",
     "class-variance-authority": ">=0.7.0",
     "clsx": ">=2.1.0",
     "cmdk": ">=1.1.0",
@@ -801,7 +801,7 @@
     "@ai-sdk/react": "^2.0.94",
     "@aws-sdk/client-s3": "^3.1011.0",
     "@aws-sdk/s3-request-presigner": "^3.1011.0",
-    "@btst/adapter-memory": "2.1.1",
+    "@btst/adapter-memory": "2.2.1",
     "@btst/yar": "1.2.0",
     "@types/react": "^19.0.0",
     "@types/slug": "^5.0.9",

package/src/plugins/cms/api/index.ts

@@ -15,5 +15,6 @@ export {
 export {
 	createCMSContentItem,
 	type CreateCMSContentItemInput,
+	type CreateCMSContentItemOptions,
 } from "./mutations";
 export { CMS_QUERY_KEYS } from "./query-key-defs";

package/src/plugins/cms/api/mutations.ts

@@ -2,6 +2,11 @@ import type { DBAdapter as Adapter } from "@btst/db";
 import type { ContentType, ContentItem } from "../types";
 import { serializeContentItem } from "./getters";
 import type { SerializedContentItem } from "../types";
+import {
+	collectExistingRelationIds,
+	extractRelationFields,
+	syncRelations,
+} from "./relations";
 
 /**
  * Input for creating a new CMS content item.
@@ -13,12 +18,37 @@ export interface CreateCMSContentItemInput {
 	data: Record<string, unknown>;
 }
 
+/**
+ * Options for {@link createCMSContentItem}.
+ */
+export interface CreateCMSContentItemOptions {
+	/**
+	 * When `true`, persist relation fields (`belongsTo`, `hasMany`,
+	 * `manyToMany`) into the `contentRelation` junction table in addition to
+	 * the item's JSON payload.
+	 *
+	 * This is what the HTTP `POST /content/:typeSlug` route does, and is
+	 * required for the admin "Related Items" panel / inverse-relation queries
+	 * to find the item.
+	 *
+	 * Seeds and other programmatic callers that want the admin UI to work
+	 * should enable this flag. Callers are still expected to pass
+	 * pre-created target IDs (`{ id }` or `[{ id }, ...]`) — inline `_new`
+	 * creation is only supported via the HTTP route.
+	 *
+	 * Defaults to `false` for backwards compatibility (a no-op for content
+	 * types without relations).
+	 */
+	syncRelations?: boolean;
+}
+
 /**
  * Create a new content item for a content type (looked up by slug).
  *
- * Bypasses Zod schema validation and relation processing — the caller is
- * responsible for providing valid, relation-free data. For relation fields or
- * schema validation, use the HTTP endpoint instead.
+ * Bypasses Zod schema validation and inline `_new` relation creation — the
+ * caller is responsible for providing valid data and pre-created relation
+ * IDs. For schema validation or inline creation of related items, use the
+ * HTTP endpoint instead.
  *
  * Throws if the content type is not found or the slug is already taken within
  * that content type.
@@ -30,11 +60,15 @@ export interface CreateCMSContentItemInput {
  * @param adapter - The database adapter
  * @param contentTypeSlug - Slug of the target content type
  * @param input - Item slug and data payload
+ * @param options - See {@link CreateCMSContentItemOptions}. Pass
+ *   `{ syncRelations: true }` to also populate the `contentRelation`
+ *   junction table for relation fields in the payload.
  */
 export async function createCMSContentItem(
 	adapter: Adapter,
 	contentTypeSlug: string,
 	input: CreateCMSContentItemInput,
+	options: CreateCMSContentItemOptions = {},
 ): Promise<SerializedContentItem> {
 	const contentType = await adapter.findOne<ContentType>({
 		model: "contentType",
@@ -80,5 +114,16 @@ export async function createCMSContentItem(
 		},
 	});
 
+	if (options.syncRelations) {
+		const relationFields = extractRelationFields(contentType);
+		if (Object.keys(relationFields).length > 0) {
+			const relationIds = collectExistingRelationIds(
+				input.data,
+				relationFields,
+			);
+			await syncRelations(adapter, item.id, relationIds);
+		}
+	}
+
 	return serializeContentItem(item);
 }

package/src/plugins/cms/api/plugin.ts

@@ -15,7 +15,6 @@ import type {
 	CMSBackendConfig,
 	CMSHookContext,
 	SerializedContentItemWithType,
-	RelationConfig,
 	RelationValue,
 	InverseRelation,
 } from "../types";
@@ -31,6 +30,12 @@ import {
 	serializeContentItemWithType,
 } from "./getters";
 import { createCMSContentItem } from "./mutations";
+import {
+	extractRelationFields,
+	isExistingRelationValue,
+	isNewRelationValue,
+	syncRelations,
+} from "./relations";
 import type { QueryClient } from "@tanstack/react-query";
 import { CMS_QUERY_KEYS } from "./query-key-defs";
 import { runHookWithShim } from "../../utils";
@@ -145,67 +150,9 @@ function getContentTypeZodSchema(contentType: ContentType): z.ZodTypeAny {
 }
 
 // ========== Relation Helpers ==========
-
-interface JsonSchemaProperty {
-	fieldType?: string;
-	relation?: RelationConfig;
-	type?: string;
-	items?: JsonSchemaProperty;
-	[key: string]: unknown;
-}
-
-interface JsonSchemaWithProperties {
-	properties?: Record<string, JsonSchemaProperty>;
-	[key: string]: unknown;
-}
-
-/**
- * Extract relation field configurations from a content type's JSON Schema
- */
-function extractRelationFields(
-	contentType: ContentType,
-): Record<string, RelationConfig> {
-	const jsonSchema = JSON.parse(
-		contentType.jsonSchema,
-	) as JsonSchemaWithProperties;
-	const properties = jsonSchema.properties || {};
-	const relationFields: Record<string, RelationConfig> = {};
-
-	for (const [fieldName, fieldSchema] of Object.entries(properties)) {
-		if (fieldSchema.fieldType === "relation" && fieldSchema.relation) {
-			relationFields[fieldName] = fieldSchema.relation;
-		}
-	}
-
-	return relationFields;
-}
-
-/**
- * Check if a value is a "new" relation item (to be created)
- */
-function isNewRelationValue(
-	value: unknown,
-): value is { _new: true; data: Record<string, unknown> } {
-	return (
-		typeof value === "object" &&
-		value !== null &&
-		"_new" in value &&
-		(value as { _new: unknown })._new === true &&
-		"data" in value
-	);
-}
-
-/**
- * Check if a value is an existing relation reference
- */
-function isExistingRelationValue(value: unknown): value is { id: string } {
-	return (
-		typeof value === "object" &&
-		value !== null &&
-		"id" in value &&
-		typeof (value as { id: unknown }).id === "string"
-	);
-}
+// `extractRelationFields`, `isNewRelationValue`, `isExistingRelationValue`,
+// and `syncRelations` live in ./relations so both this HTTP route module
+// and the programmatic mutations helper can share them.
 
 /**
  * Process relation fields in content data:
@@ -363,44 +310,6 @@ async function createRelatedItem(
 	return item;
 }
 
-/**
- * Sync relations in the junction table for a content item.
- *
- * Only updates relations for fields explicitly present in relationIds.
- * Fields not in relationIds are left unchanged - this preserves existing
- * relations during partial updates.
- */
-async function syncRelations(
-	adapter: Adapter,
-	sourceId: string,
-	relationIds: Record<string, string[]>,
-): Promise<void> {
-	// Only sync fields that are explicitly included in relationIds
-	for (const [fieldName, targetIds] of Object.entries(relationIds)) {
-		// Delete existing relations for this specific field only
-		await adapter.delete({
-			model: "contentRelation",
-			where: [
-				{ field: "sourceId", value: sourceId, operator: "eq" as const },
-				{ field: "fieldName", value: fieldName, operator: "eq" as const },
-			],
-		});
-
-		// Create new relations for this field
-		for (const targetId of targetIds) {
-			await adapter.create<ContentRelation>({
-				model: "contentRelation",
-				data: {
-					sourceId,
-					targetId,
-					fieldName,
-					createdAt: new Date(),
-				},
-			});
-		}
-	}
-}
-
 /**
  * Populate relations for a content item by fetching related items
  */
@@ -575,9 +484,10 @@ export const cmsBackendPlugin = (config: CMSBackendConfig) => {
 			createContentItem: async (
 				typeSlug: string,
 				input: Parameters<typeof createCMSContentItem>[2],
+				options?: Parameters<typeof createCMSContentItem>[3],
 			) => {
 				await ensureSynced(adapter);
-				return createCMSContentItem(adapter, typeSlug, input);
+				return createCMSContentItem(adapter, typeSlug, input, options);
 			},
 		}),