@btst/plugin-cms 0.0.0-stage → 1.0.0

package/dist/api/index.d.cts

@@ -0,0 +1,209 @@
+export { C as CMSApiRouter, a as CMSRouteKey, b as CMS_QUERY_KEYS, c as cmsBackendPlugin, d as createCMSQueryKeys } from '../shared/plugin-cms.c-GeWvTf.cjs';
+import { DBAdapter } from '@btst/db';
+import { CMSReadView, CMSContentFields, CMSReadOptions, CMSContentItemResult, SerializedContentType, ContentItem, SerializedContentItem, ContentItemWithType, SerializedContentItemWithType, ContentType } from '../types.cjs';
+export { CMSBackendConfig, CMSBackendHooks, CMSCreateOperationContext, CMSCreateResultContext, CMSDeleteOperationContext, CMSDeleteResultContext, CMSOperationErrorContext, CMSOperationLifecycleContext, CMSSelectedData, CMSUpdateOperationContext, CMSUpdateResultContext, ContentTypeConfig, PaginatedContentItems, SerializedContentItemContent } from '../types.cjs';
+import { z } from 'zod';
+import '@btst/stack/plugins/client';
+import '@btst/stack/authorization';
+import '@btst/stack/plugins/api';
+import 'better-call';
+import '@tanstack/react-query';
+
+/**
+ * Removed CMS lifecycle names and their canonical v3 replacements.
+ *
+ * The aggregate error callback remains one phase. Its operation argument
+ * distinguishes create, update, delete, list, and get failures.
+ */
+declare const CMS_LIFECYCLE_HOOK_MIGRATIONS: Readonly<{
+    readonly onBeforeCreate: "onBeforeCreateContent";
+    readonly onAfterCreate: "onAfterCreateContent";
+    readonly onBeforeUpdate: "onBeforeUpdateContent";
+    readonly onAfterUpdate: "onAfterUpdateContent";
+    readonly onBeforeDelete: "onBeforeDeleteContent";
+    readonly onAfterDelete: "onAfterDeleteContent";
+    readonly onError: "onErrorExecuteContentOperation";
+}>;
+
+/**
+ * Serialize a ContentType for SSR/SSG use (convert dates to strings).
+ * Applies lazy migration for legacy schemas (version 1 → 2).
+ */
+declare function serializeContentType(ct: ContentType): SerializedContentType;
+/**
+ * Serialize a ContentItem for SSR/SSG use (convert dates to strings).
+ */
+declare function serializeContentItem(item: ContentItem): SerializedContentItem;
+/**
+ * Serialize a ContentItem with parsed data and joined ContentType.
+ * Throws a SyntaxError if `item.data` is not valid JSON, so corrupted rows
+ * produce a visible, debuggable error rather than silently returning null.
+ */
+declare function serializeContentItemWithType(item: ContentItemWithType): SerializedContentItemWithType;
+/**
+ * Retrieve all content types.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ */
+declare function getAllContentTypes(adapter: DBAdapter): Promise<SerializedContentType[]>;
+/**
+ * Retrieve all content items for a given content type, with optional pagination
+ * and free-text search.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param contentTypeSlug - The slug of the content type to query
+ * @param params - Optional filter/pagination parameters. `search` matches
+ * case-insensitively against item slugs and string values in the item data.
+ */
+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;
+} & CMSReadOptions<TView, TFields>): Promise<{
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}>;
+/**
+ * Retrieve a single content item by its ID.
+ * Returns null if the item is not found.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The content item ID (UUID)
+ */
+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.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param contentTypeSlug - The slug of the content type
+ * @param slug - The slug of the content item
+ */
+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;
+}, z.core.$strip>;
+declare const CMSContentItemParamsSchema: z.ZodObject<{
+    typeSlug: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>;
+declare const CMSCreateContentItemBodySchema: z.ZodObject<{
+    slug: z.ZodString;
+    data: z.ZodType<Record<string, any>, unknown, z.core.$ZodTypeInternals<Record<string, any>, unknown>>;
+}, z.core.$strip>;
+declare const CMSUpdateContentItemBodySchema: z.ZodObject<{
+    slug: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodType<Record<string, any>, unknown, z.core.$ZodTypeInternals<Record<string, any>, unknown>>>;
+}, z.core.$strip>;
+
+/**
+ * Input for creating a new CMS content item.
+ */
+interface CreateCMSContentItemInput {
+    /** URL-safe slug for the item */
+    slug: string;
+    /** 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 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.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @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, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
+
+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/api/index.d.mts

@@ -0,0 +1,209 @@
+export { C as CMSApiRouter, a as CMSRouteKey, b as CMS_QUERY_KEYS, c as cmsBackendPlugin, d as createCMSQueryKeys } from '../shared/plugin-cms.W4Le8D91.mjs';
+import { DBAdapter } from '@btst/db';
+import { CMSReadView, CMSContentFields, CMSReadOptions, CMSContentItemResult, SerializedContentType, ContentItem, SerializedContentItem, ContentItemWithType, SerializedContentItemWithType, ContentType } from '../types.mjs';
+export { CMSBackendConfig, CMSBackendHooks, CMSCreateOperationContext, CMSCreateResultContext, CMSDeleteOperationContext, CMSDeleteResultContext, CMSOperationErrorContext, CMSOperationLifecycleContext, CMSSelectedData, CMSUpdateOperationContext, CMSUpdateResultContext, ContentTypeConfig, PaginatedContentItems, SerializedContentItemContent } from '../types.mjs';
+import { z } from 'zod';
+import '@btst/stack/plugins/client';
+import '@btst/stack/authorization';
+import '@btst/stack/plugins/api';
+import 'better-call';
+import '@tanstack/react-query';
+
+/**
+ * Removed CMS lifecycle names and their canonical v3 replacements.
+ *
+ * The aggregate error callback remains one phase. Its operation argument
+ * distinguishes create, update, delete, list, and get failures.
+ */
+declare const CMS_LIFECYCLE_HOOK_MIGRATIONS: Readonly<{
+    readonly onBeforeCreate: "onBeforeCreateContent";
+    readonly onAfterCreate: "onAfterCreateContent";
+    readonly onBeforeUpdate: "onBeforeUpdateContent";
+    readonly onAfterUpdate: "onAfterUpdateContent";
+    readonly onBeforeDelete: "onBeforeDeleteContent";
+    readonly onAfterDelete: "onAfterDeleteContent";
+    readonly onError: "onErrorExecuteContentOperation";
+}>;
+
+/**
+ * Serialize a ContentType for SSR/SSG use (convert dates to strings).
+ * Applies lazy migration for legacy schemas (version 1 → 2).
+ */
+declare function serializeContentType(ct: ContentType): SerializedContentType;
+/**
+ * Serialize a ContentItem for SSR/SSG use (convert dates to strings).
+ */
+declare function serializeContentItem(item: ContentItem): SerializedContentItem;
+/**
+ * Serialize a ContentItem with parsed data and joined ContentType.
+ * Throws a SyntaxError if `item.data` is not valid JSON, so corrupted rows
+ * produce a visible, debuggable error rather than silently returning null.
+ */
+declare function serializeContentItemWithType(item: ContentItemWithType): SerializedContentItemWithType;
+/**
+ * Retrieve all content types.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ */
+declare function getAllContentTypes(adapter: DBAdapter): Promise<SerializedContentType[]>;
+/**
+ * Retrieve all content items for a given content type, with optional pagination
+ * and free-text search.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param contentTypeSlug - The slug of the content type to query
+ * @param params - Optional filter/pagination parameters. `search` matches
+ * case-insensitively against item slugs and string values in the item data.
+ */
+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;
+} & CMSReadOptions<TView, TFields>): Promise<{
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}>;
+/**
+ * Retrieve a single content item by its ID.
+ * Returns null if the item is not found.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The content item ID (UUID)
+ */
+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.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param contentTypeSlug - The slug of the content type
+ * @param slug - The slug of the content item
+ */
+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;
+}, z.core.$strip>;
+declare const CMSContentItemParamsSchema: z.ZodObject<{
+    typeSlug: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>;
+declare const CMSCreateContentItemBodySchema: z.ZodObject<{
+    slug: z.ZodString;
+    data: z.ZodType<Record<string, any>, unknown, z.core.$ZodTypeInternals<Record<string, any>, unknown>>;
+}, z.core.$strip>;
+declare const CMSUpdateContentItemBodySchema: z.ZodObject<{
+    slug: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodType<Record<string, any>, unknown, z.core.$ZodTypeInternals<Record<string, any>, unknown>>>;
+}, z.core.$strip>;
+
+/**
+ * Input for creating a new CMS content item.
+ */
+interface CreateCMSContentItemInput {
+    /** URL-safe slug for the item */
+    slug: string;
+    /** 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 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.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @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, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
+
+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/api/index.d.ts

@@ -0,0 +1,209 @@
+export { C as CMSApiRouter, a as CMSRouteKey, b as CMS_QUERY_KEYS, c as cmsBackendPlugin, d as createCMSQueryKeys } from '../shared/plugin-cms.DQLAoogy.js';
+import { DBAdapter } from '@btst/db';
+import { CMSReadView, CMSContentFields, CMSReadOptions, CMSContentItemResult, SerializedContentType, ContentItem, SerializedContentItem, ContentItemWithType, SerializedContentItemWithType, ContentType } from '../types.js';
+export { CMSBackendConfig, CMSBackendHooks, CMSCreateOperationContext, CMSCreateResultContext, CMSDeleteOperationContext, CMSDeleteResultContext, CMSOperationErrorContext, CMSOperationLifecycleContext, CMSSelectedData, CMSUpdateOperationContext, CMSUpdateResultContext, ContentTypeConfig, PaginatedContentItems, SerializedContentItemContent } from '../types.js';
+import { z } from 'zod';
+import '@btst/stack/plugins/client';
+import '@btst/stack/authorization';
+import '@btst/stack/plugins/api';
+import 'better-call';
+import '@tanstack/react-query';
+
+/**
+ * Removed CMS lifecycle names and their canonical v3 replacements.
+ *
+ * The aggregate error callback remains one phase. Its operation argument
+ * distinguishes create, update, delete, list, and get failures.
+ */
+declare const CMS_LIFECYCLE_HOOK_MIGRATIONS: Readonly<{
+    readonly onBeforeCreate: "onBeforeCreateContent";
+    readonly onAfterCreate: "onAfterCreateContent";
+    readonly onBeforeUpdate: "onBeforeUpdateContent";
+    readonly onAfterUpdate: "onAfterUpdateContent";
+    readonly onBeforeDelete: "onBeforeDeleteContent";
+    readonly onAfterDelete: "onAfterDeleteContent";
+    readonly onError: "onErrorExecuteContentOperation";
+}>;
+
+/**
+ * Serialize a ContentType for SSR/SSG use (convert dates to strings).
+ * Applies lazy migration for legacy schemas (version 1 → 2).
+ */
+declare function serializeContentType(ct: ContentType): SerializedContentType;
+/**
+ * Serialize a ContentItem for SSR/SSG use (convert dates to strings).
+ */
+declare function serializeContentItem(item: ContentItem): SerializedContentItem;
+/**
+ * Serialize a ContentItem with parsed data and joined ContentType.
+ * Throws a SyntaxError if `item.data` is not valid JSON, so corrupted rows
+ * produce a visible, debuggable error rather than silently returning null.
+ */
+declare function serializeContentItemWithType(item: ContentItemWithType): SerializedContentItemWithType;
+/**
+ * Retrieve all content types.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ */
+declare function getAllContentTypes(adapter: DBAdapter): Promise<SerializedContentType[]>;
+/**
+ * Retrieve all content items for a given content type, with optional pagination
+ * and free-text search.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param contentTypeSlug - The slug of the content type to query
+ * @param params - Optional filter/pagination parameters. `search` matches
+ * case-insensitively against item slugs and string values in the item data.
+ */
+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;
+} & CMSReadOptions<TView, TFields>): Promise<{
+    items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}>;
+/**
+ * Retrieve a single content item by its ID.
+ * Returns null if the item is not found.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The content item ID (UUID)
+ */
+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.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param contentTypeSlug - The slug of the content type
+ * @param slug - The slug of the content item
+ */
+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;
+}, z.core.$strip>;
+declare const CMSContentItemParamsSchema: z.ZodObject<{
+    typeSlug: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>;
+declare const CMSCreateContentItemBodySchema: z.ZodObject<{
+    slug: z.ZodString;
+    data: z.ZodType<Record<string, any>, unknown, z.core.$ZodTypeInternals<Record<string, any>, unknown>>;
+}, z.core.$strip>;
+declare const CMSUpdateContentItemBodySchema: z.ZodObject<{
+    slug: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodType<Record<string, any>, unknown, z.core.$ZodTypeInternals<Record<string, any>, unknown>>>;
+}, z.core.$strip>;
+
+/**
+ * Input for creating a new CMS content item.
+ */
+interface CreateCMSContentItemInput {
+    /** URL-safe slug for the item */
+    slug: string;
+    /** 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 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.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @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, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
+
+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/api/index.mjs

@@ -0,0 +1,7 @@
+export { cmsBackendPlugin } from './plugin.mjs';
+export { getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, getContentItemsByRelation, serializeContentItem, serializeContentItemWithType, serializeContentType } from './getters.mjs';
+export { createCMSContentItem } from './mutations.mjs';
+export { CMS_QUERY_KEYS } from './query-key-defs.mjs';
+export { createCMSQueryKeys } from '../query-keys.mjs';
+export { CMSContentItemParamsSchema, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSUpdateContentItemBodySchema } from './operations.mjs';
+export { CMS_LIFECYCLE_HOOK_MIGRATIONS } from './lifecycle-migrations.mjs';

package/dist/api/lifecycle-migrations.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+const CMS_LIFECYCLE_HOOK_MIGRATIONS = Object.freeze({
+  onBeforeCreate: "onBeforeCreateContent",
+  onAfterCreate: "onAfterCreateContent",
+  onBeforeUpdate: "onBeforeUpdateContent",
+  onAfterUpdate: "onAfterUpdateContent",
+  onBeforeDelete: "onBeforeDeleteContent",
+  onAfterDelete: "onAfterDeleteContent",
+  onError: "onErrorExecuteContentOperation"
+});
+
+exports.CMS_LIFECYCLE_HOOK_MIGRATIONS = CMS_LIFECYCLE_HOOK_MIGRATIONS;

package/dist/api/lifecycle-migrations.mjs

@@ -0,0 +1,11 @@
+const CMS_LIFECYCLE_HOOK_MIGRATIONS = Object.freeze({
+  onBeforeCreate: "onBeforeCreateContent",
+  onAfterCreate: "onAfterCreateContent",
+  onBeforeUpdate: "onBeforeUpdateContent",
+  onAfterUpdate: "onAfterUpdateContent",
+  onBeforeDelete: "onBeforeDeleteContent",
+  onAfterDelete: "onAfterDeleteContent",
+  onError: "onErrorExecuteContentOperation"
+});
+
+export { CMS_LIFECYCLE_HOOK_MIGRATIONS };