@btst/plugin-cms 1.0.0 → 1.2.0-beta.0

package/dist/api/getters.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+const publication = require('./publication.cjs');
 const schemas = require('../schemas.cjs');
 
 class CMSContentSelectionError extends Error {
@@ -68,6 +69,7 @@ function migrateToUnifiedSchema(jsonSchemaStr, fieldConfigStr) {
 function serializeContentItem(item) {
   return {
     ...item,
+    publishAt: item.publishAt?.toISOString() ?? null,
     createdAt: item.createdAt.toISOString(),
     updatedAt: item.updatedAt.toISOString()
   };
@@ -99,7 +101,7 @@ function contentItemMatchesSearch(item, searchLower) {
     return false;
   });
 }
-async function getAllContentItems(adapter, contentTypeSlug, params) {
+async function getAllContentItems(adapter, contentTypeSlug, params, publication$1) {
   const contentType = await adapter.findOne({
     model: "contentType",
     where: [
@@ -134,24 +136,29 @@ async function getAllContentItems(adapter, contentTypeSlug, params) {
     });
   }
   const search = params?.search?.trim();
-  const needsInMemoryFilter = !!search;
+  const needsInMemoryFilter = !!search || !!publication$1;
   const dbTotal = !needsInMemoryFilter ? await adapter.count({
     model: "contentItem",
     where: whereConditions
   }) : void 0;
-  const items = await adapter.findMany({
-    model: "contentItem",
-    where: whereConditions,
-    limit: !needsInMemoryFilter ? params?.limit : schemas.DEFAULT_MAX_PAGE_SIZE,
-    offset: !needsInMemoryFilter ? params?.offset : void 0,
-    sortBy: { field: "createdAt", direction: "desc" },
-    join: { contentType: true }
-  });
-  let result = items.map(serializeContentItemWithType);
+  const items = [];
+  for (let scanOffset = 0; ; scanOffset += schemas.DEFAULT_MAX_PAGE_SIZE) {
+    const batch = await adapter.findMany({
+      model: "contentItem",
+      where: whereConditions,
+      limit: !needsInMemoryFilter ? params?.limit : schemas.DEFAULT_MAX_PAGE_SIZE,
+      offset: needsInMemoryFilter ? scanOffset : params?.offset,
+      sortBy: { field: "createdAt", direction: "desc" },
+      join: { contentType: true }
+    });
+    items.push(...batch);
+    if (!publication$1 || batch.length < schemas.DEFAULT_MAX_PAGE_SIZE) break;
+  }
+  let result = items.filter((item) => !publication$1 || publication.isPublishedContent(item, publication$1)).map(serializeContentItemWithType);
   if (needsInMemoryFilter) {
-    const searchLower = search.toLowerCase();
+    const searchLower = search?.toLowerCase();
     result = result.filter(
-      (item) => contentItemMatchesSearch(item, searchLower)
+      (item) => !searchLower || contentItemMatchesSearch(item, searchLower)
     );
     const total = result.length;
     const offset = params?.offset ?? 0;
@@ -174,17 +181,18 @@ async function getAllContentItems(adapter, contentTypeSlug, params) {
     offset: params?.offset
   };
 }
-async function getContentItemById(adapter, id, options) {
+async function getContentItemById(adapter, id, options, publication$1) {
   const item = await adapter.findOne({
     model: "contentItem",
     where: [{ field: "id", value: id, operator: "eq" }],
     join: { contentType: true }
   });
-  if (!item) return null;
+  if (!item || publication$1 && !publication.isPublishedContent(item, publication$1))
+    return null;
   validateContentReadOptions(item.contentType, options);
   return applyContentReadOptions(serializeContentItemWithType(item), options);
 }
-async function getContentItemBySlug(adapter, contentTypeSlug, slug, options) {
+async function getContentItemBySlug(adapter, contentTypeSlug, slug, options, publication$1) {
   const contentType = await adapter.findOne({
     model: "contentType",
     where: [
@@ -211,12 +219,12 @@ async function getContentItemBySlug(adapter, contentTypeSlug, slug, options) {
     ],
     join: { contentType: true }
   });
-  if (!item) {
+  if (!item || publication$1 && !publication.isPublishedContent(item, publication$1)) {
     return null;
   }
   return applyContentReadOptions(serializeContentItemWithType(item), options);
 }
-async function getContentItemsByRelation(adapter, contentTypeSlug, params) {
+async function getContentItemsByRelation(adapter, contentTypeSlug, params, publication) {
   const contentType = await adapter.findOne({
     model: "contentType",
     where: [{ field: "slug", value: contentTypeSlug, operator: "eq" }]
@@ -233,14 +241,15 @@ async function getContentItemsByRelation(adapter, contentTypeSlug, params) {
   const result = await getContentItemsByRelationForType(
     adapter,
     contentType,
-    params
+    params,
+    publication
   );
   return {
     ...result,
     items: result.items.map((item) => applyContentReadOptions(item, params))
   };
 }
-async function getContentItemsByRelationForType(adapter, contentType, params) {
+async function getContentItemsByRelationForType(adapter, contentType, params, publication$1) {
   const limit = params.limit ?? 20;
   const offset = params.offset ?? 0;
   const batchSize = 100;
@@ -276,15 +285,18 @@ async function getContentItemsByRelationForType(adapter, contentType, params) {
           },
           { field: "contentTypeId", value: contentType.id, operator: "eq" }
         ],
-        select: ["id", "createdAt"],
+        select: publication$1 ? ["id", "createdAt", "data", "publishAt"] : ["id", "createdAt"],
         limit: batchSize
       })
     );
   }
-  metadata.sort(
+  const visibleMetadata = metadata.filter(
+    (item) => !publication$1 || "data" in item && publication.isPublishedContent(item, publication$1)
+  );
+  visibleMetadata.sort(
     (left, right) => right.createdAt.getTime() - left.createdAt.getTime() || (left.id < right.id ? 1 : left.id > right.id ? -1 : 0)
   );
-  const pageIds = metadata.slice(offset, offset + limit).map((item) => item.id);
+  const pageIds = visibleMetadata.slice(offset, offset + limit).map((item) => item.id);
   const itemsById = /* @__PURE__ */ new Map();
   for (let start = 0; start < pageIds.length; start += batchSize) {
     const items = await adapter.findMany({
@@ -305,9 +317,9 @@ async function getContentItemsByRelationForType(adapter, contentType, params) {
   return {
     items: pageIds.flatMap((id) => {
       const item = itemsById.get(id);
-      return item ? [serializeContentItemWithType(item)] : [];
+      return item && (!publication$1 || publication.isPublishedContent(item, publication$1)) ? [serializeContentItemWithType(item)] : [];
     }),
-    total: metadata.length,
+    total: visibleMetadata.length,
     limit,
     offset
   };

package/dist/api/getters.mjs

@@ -1,3 +1,4 @@
+import { isPublishedContent } from './publication.mjs';
 import { DEFAULT_MAX_PAGE_SIZE, contentReadOptionsSchema, normalizeContentFields } from '../schemas.mjs';
 
 class CMSContentSelectionError extends Error {
@@ -66,6 +67,7 @@ function migrateToUnifiedSchema(jsonSchemaStr, fieldConfigStr) {
 function serializeContentItem(item) {
   return {
     ...item,
+    publishAt: item.publishAt?.toISOString() ?? null,
     createdAt: item.createdAt.toISOString(),
     updatedAt: item.updatedAt.toISOString()
   };
@@ -97,7 +99,7 @@ function contentItemMatchesSearch(item, searchLower) {
     return false;
   });
 }
-async function getAllContentItems(adapter, contentTypeSlug, params) {
+async function getAllContentItems(adapter, contentTypeSlug, params, publication) {
   const contentType = await adapter.findOne({
     model: "contentType",
     where: [
@@ -132,24 +134,29 @@ async function getAllContentItems(adapter, contentTypeSlug, params) {
     });
   }
   const search = params?.search?.trim();
-  const needsInMemoryFilter = !!search;
+  const needsInMemoryFilter = !!search || !!publication;
   const dbTotal = !needsInMemoryFilter ? await adapter.count({
     model: "contentItem",
     where: whereConditions
   }) : void 0;
-  const items = await adapter.findMany({
-    model: "contentItem",
-    where: whereConditions,
-    limit: !needsInMemoryFilter ? params?.limit : DEFAULT_MAX_PAGE_SIZE,
-    offset: !needsInMemoryFilter ? params?.offset : void 0,
-    sortBy: { field: "createdAt", direction: "desc" },
-    join: { contentType: true }
-  });
-  let result = items.map(serializeContentItemWithType);
+  const items = [];
+  for (let scanOffset = 0; ; scanOffset += DEFAULT_MAX_PAGE_SIZE) {
+    const batch = await adapter.findMany({
+      model: "contentItem",
+      where: whereConditions,
+      limit: !needsInMemoryFilter ? params?.limit : DEFAULT_MAX_PAGE_SIZE,
+      offset: needsInMemoryFilter ? scanOffset : params?.offset,
+      sortBy: { field: "createdAt", direction: "desc" },
+      join: { contentType: true }
+    });
+    items.push(...batch);
+    if (!publication || batch.length < DEFAULT_MAX_PAGE_SIZE) break;
+  }
+  let result = items.filter((item) => !publication || isPublishedContent(item, publication)).map(serializeContentItemWithType);
   if (needsInMemoryFilter) {
-    const searchLower = search.toLowerCase();
+    const searchLower = search?.toLowerCase();
     result = result.filter(
-      (item) => contentItemMatchesSearch(item, searchLower)
+      (item) => !searchLower || contentItemMatchesSearch(item, searchLower)
     );
     const total = result.length;
     const offset = params?.offset ?? 0;
@@ -172,17 +179,18 @@ async function getAllContentItems(adapter, contentTypeSlug, params) {
     offset: params?.offset
   };
 }
-async function getContentItemById(adapter, id, options) {
+async function getContentItemById(adapter, id, options, publication) {
   const item = await adapter.findOne({
     model: "contentItem",
     where: [{ field: "id", value: id, operator: "eq" }],
     join: { contentType: true }
   });
-  if (!item) return null;
+  if (!item || publication && !isPublishedContent(item, publication))
+    return null;
   validateContentReadOptions(item.contentType, options);
   return applyContentReadOptions(serializeContentItemWithType(item), options);
 }
-async function getContentItemBySlug(adapter, contentTypeSlug, slug, options) {
+async function getContentItemBySlug(adapter, contentTypeSlug, slug, options, publication) {
   const contentType = await adapter.findOne({
     model: "contentType",
     where: [
@@ -209,12 +217,12 @@ async function getContentItemBySlug(adapter, contentTypeSlug, slug, options) {
     ],
     join: { contentType: true }
   });
-  if (!item) {
+  if (!item || publication && !isPublishedContent(item, publication)) {
     return null;
   }
   return applyContentReadOptions(serializeContentItemWithType(item), options);
 }
-async function getContentItemsByRelation(adapter, contentTypeSlug, params) {
+async function getContentItemsByRelation(adapter, contentTypeSlug, params, publication) {
   const contentType = await adapter.findOne({
     model: "contentType",
     where: [{ field: "slug", value: contentTypeSlug, operator: "eq" }]
@@ -231,14 +239,15 @@ async function getContentItemsByRelation(adapter, contentTypeSlug, params) {
   const result = await getContentItemsByRelationForType(
     adapter,
     contentType,
-    params
+    params,
+    publication
   );
   return {
     ...result,
     items: result.items.map((item) => applyContentReadOptions(item, params))
   };
 }
-async function getContentItemsByRelationForType(adapter, contentType, params) {
+async function getContentItemsByRelationForType(adapter, contentType, params, publication) {
   const limit = params.limit ?? 20;
   const offset = params.offset ?? 0;
   const batchSize = 100;
@@ -274,15 +283,18 @@ async function getContentItemsByRelationForType(adapter, contentType, params) {
           },
           { field: "contentTypeId", value: contentType.id, operator: "eq" }
         ],
-        select: ["id", "createdAt"],
+        select: publication ? ["id", "createdAt", "data", "publishAt"] : ["id", "createdAt"],
         limit: batchSize
       })
     );
   }
-  metadata.sort(
+  const visibleMetadata = metadata.filter(
+    (item) => !publication || "data" in item && isPublishedContent(item, publication)
+  );
+  visibleMetadata.sort(
     (left, right) => right.createdAt.getTime() - left.createdAt.getTime() || (left.id < right.id ? 1 : left.id > right.id ? -1 : 0)
   );
-  const pageIds = metadata.slice(offset, offset + limit).map((item) => item.id);
+  const pageIds = visibleMetadata.slice(offset, offset + limit).map((item) => item.id);
   const itemsById = /* @__PURE__ */ new Map();
   for (let start = 0; start < pageIds.length; start += batchSize) {
     const items = await adapter.findMany({
@@ -303,9 +315,9 @@ async function getContentItemsByRelationForType(adapter, contentType, params) {
   return {
     items: pageIds.flatMap((id) => {
       const item = itemsById.get(id);
-      return item ? [serializeContentItemWithType(item)] : [];
+      return item && (!publication || isPublishedContent(item, publication)) ? [serializeContentItemWithType(item)] : [];
     }),
-    total: metadata.length,
+    total: visibleMetadata.length,
     limit,
     offset
   };

package/dist/api/index.cjs

@@ -20,6 +20,7 @@ exports.serializeContentItem = getters.serializeContentItem;
 exports.serializeContentItemWithType = getters.serializeContentItemWithType;
 exports.serializeContentType = getters.serializeContentType;
 exports.createCMSContentItem = mutations.createCMSContentItem;
+exports.recordContentRevision = mutations.recordContentRevision;
 exports.CMS_QUERY_KEYS = queryKeyDefs.CMS_QUERY_KEYS;
 exports.createCMSQueryKeys = queryKeys.createCMSQueryKeys;
 exports.CMSContentItemParamsSchema = operations.CMSContentItemParamsSchema;

package/dist/api/index.d.cts

@@ -1,7 +1,7 @@
-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';
+export { C as CMSApiRouter, a as CMSRouteKey, b as CMS_QUERY_KEYS, c as cmsBackendPlugin, d as createCMSQueryKeys } from '../shared/plugin-cms.DJ_293QU.cjs';
+import { CMSReadView, CMSContentFields, CMSReadOptions, CMSContentItemResult, CMSPublicationPolicy, SerializedContentType, ContentItem, SerializedContentItem, ContentItemWithType, SerializedContentItemWithType, ContentType, ContentRevision } from '../types.cjs';
+export { CMSBackendConfig, CMSBackendHooks, CMSCreateOperationContext, CMSCreateResultContext, CMSDeleteOperationContext, CMSDeleteResultContext, CMSOperationErrorContext, CMSOperationLifecycleContext, CMSSelectedData, CMSUpdateOperationContext, CMSUpdateResultContext, ContentTypeConfig, PaginatedContentItems, SerializedContentItemContent, SerializedContentRevision } from '../types.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';
@@ -69,7 +69,7 @@ declare function getAllContentItems<TView extends CMSReadView = undefined, const
     limit?: number;
     offset?: number;
     search?: string;
-} & CMSReadOptions<TView, TFields>): Promise<{
+} & CMSReadOptions<TView, TFields>, publication?: CMSPublicationPolicy): Promise<{
     items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
     total: number;
     limit?: number;
@@ -86,7 +86,7 @@ declare function getAllContentItems<TView extends CMSReadView = undefined, const
  * @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>;
+declare function getContentItemById<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, id: string, options?: CMSReadOptions<TView, TFields>, publication?: CMSPublicationPolicy): 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.
@@ -99,7 +99,7 @@ declare function getContentItemById<TView extends CMSReadView = undefined, const
  * @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>;
+declare function getContentItemBySlug<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, slug: string, options?: CMSReadOptions<TView, TFields>, publication?: CMSPublicationPolicy): 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. */
@@ -131,7 +131,7 @@ interface ContentItemsByRelationResult<TView extends CMSReadView = undefined, TF
  * 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 function getContentItemsByRelation<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, params: ContentItemsByRelationParams<TView, TFields>, publication?: CMSPublicationPolicy): Promise<ContentItemsByRelationResult<TView, TFields>>;
 
 declare const CMSContentTypeParamsSchema: z.ZodObject<{
     slug: z.ZodString;
@@ -143,10 +143,12 @@ declare const CMSContentItemParamsSchema: z.ZodObject<{
 declare const CMSCreateContentItemBodySchema: z.ZodObject<{
     slug: z.ZodString;
     data: z.ZodType<Record<string, any>, unknown, z.core.$ZodTypeInternals<Record<string, any>, unknown>>;
+    publishAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
 }, 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>>>;
+    publishAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
 }, z.core.$strip>;
 
 /**
@@ -157,7 +159,14 @@ interface CreateCMSContentItemInput {
     slug: string;
     /** Arbitrary data payload — should match the content type schema */
     data: Record<string, unknown>;
+    /** Optional scheduled publication timestamp. */
+    publishAt?: Date | null;
 }
+/**
+ * Append a snapshot; caller owns authorization, validation, lifecycle hooks, and
+ * the transaction containing the item write. Revision rows are never updated.
+ */
+declare function recordContentRevision(adapter: Omit<DBAdapter, "transaction">, item: ContentItem, authorId?: string): Promise<ContentRevision>;
 /**
  * Options for {@link createCMSContentItem}.
  */
@@ -205,5 +214,5 @@ interface CreateCMSContentItemOptions {
  */
 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 { CMSContentFields, CMSContentItemParamsSchema, CMSContentItemResult, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSPublicationPolicy, CMSReadOptions, CMSReadView, CMSUpdateContentItemBodySchema, CMS_LIFECYCLE_HOOK_MIGRATIONS, ContentRevision, createCMSContentItem, getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, getContentItemsByRelation, recordContentRevision, serializeContentItem, serializeContentItemWithType, serializeContentType };
 export type { ContentItemsByRelationParams, ContentItemsByRelationResult, CreateCMSContentItemInput, CreateCMSContentItemOptions };

package/dist/api/index.d.mts

@@ -1,7 +1,7 @@
-export { C as CMSApiRouter, a as CMSRouteKey, b as CMS_QUERY_KEYS, c as cmsBackendPlugin, d as createCMSQueryKeys } from '../shared/plugin-cms.W4Le8D91.mjs';
+export { C as CMSApiRouter, a as CMSRouteKey, b as CMS_QUERY_KEYS, c as cmsBackendPlugin, d as createCMSQueryKeys } from '../shared/plugin-cms.DAAUZ41w.mjs';
+import { CMSReadView, CMSContentFields, CMSReadOptions, CMSContentItemResult, CMSPublicationPolicy, SerializedContentType, ContentItem, SerializedContentItem, ContentItemWithType, SerializedContentItemWithType, ContentType, ContentRevision } from '../types.mjs';
+export { CMSBackendConfig, CMSBackendHooks, CMSCreateOperationContext, CMSCreateResultContext, CMSDeleteOperationContext, CMSDeleteResultContext, CMSOperationErrorContext, CMSOperationLifecycleContext, CMSSelectedData, CMSUpdateOperationContext, CMSUpdateResultContext, ContentTypeConfig, PaginatedContentItems, SerializedContentItemContent, SerializedContentRevision } from '../types.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';
@@ -69,7 +69,7 @@ declare function getAllContentItems<TView extends CMSReadView = undefined, const
     limit?: number;
     offset?: number;
     search?: string;
-} & CMSReadOptions<TView, TFields>): Promise<{
+} & CMSReadOptions<TView, TFields>, publication?: CMSPublicationPolicy): Promise<{
     items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
     total: number;
     limit?: number;
@@ -86,7 +86,7 @@ declare function getAllContentItems<TView extends CMSReadView = undefined, const
  * @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>;
+declare function getContentItemById<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, id: string, options?: CMSReadOptions<TView, TFields>, publication?: CMSPublicationPolicy): 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.
@@ -99,7 +99,7 @@ declare function getContentItemById<TView extends CMSReadView = undefined, const
  * @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>;
+declare function getContentItemBySlug<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, slug: string, options?: CMSReadOptions<TView, TFields>, publication?: CMSPublicationPolicy): 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. */
@@ -131,7 +131,7 @@ interface ContentItemsByRelationResult<TView extends CMSReadView = undefined, TF
  * 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 function getContentItemsByRelation<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, params: ContentItemsByRelationParams<TView, TFields>, publication?: CMSPublicationPolicy): Promise<ContentItemsByRelationResult<TView, TFields>>;
 
 declare const CMSContentTypeParamsSchema: z.ZodObject<{
     slug: z.ZodString;
@@ -143,10 +143,12 @@ declare const CMSContentItemParamsSchema: z.ZodObject<{
 declare const CMSCreateContentItemBodySchema: z.ZodObject<{
     slug: z.ZodString;
     data: z.ZodType<Record<string, any>, unknown, z.core.$ZodTypeInternals<Record<string, any>, unknown>>;
+    publishAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
 }, 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>>>;
+    publishAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
 }, z.core.$strip>;
 
 /**
@@ -157,7 +159,14 @@ interface CreateCMSContentItemInput {
     slug: string;
     /** Arbitrary data payload — should match the content type schema */
     data: Record<string, unknown>;
+    /** Optional scheduled publication timestamp. */
+    publishAt?: Date | null;
 }
+/**
+ * Append a snapshot; caller owns authorization, validation, lifecycle hooks, and
+ * the transaction containing the item write. Revision rows are never updated.
+ */
+declare function recordContentRevision(adapter: Omit<DBAdapter, "transaction">, item: ContentItem, authorId?: string): Promise<ContentRevision>;
 /**
  * Options for {@link createCMSContentItem}.
  */
@@ -205,5 +214,5 @@ interface CreateCMSContentItemOptions {
  */
 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 { CMSContentFields, CMSContentItemParamsSchema, CMSContentItemResult, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSPublicationPolicy, CMSReadOptions, CMSReadView, CMSUpdateContentItemBodySchema, CMS_LIFECYCLE_HOOK_MIGRATIONS, ContentRevision, createCMSContentItem, getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, getContentItemsByRelation, recordContentRevision, serializeContentItem, serializeContentItemWithType, serializeContentType };
 export type { ContentItemsByRelationParams, ContentItemsByRelationResult, CreateCMSContentItemInput, CreateCMSContentItemOptions };

package/dist/api/index.d.ts

@@ -1,7 +1,7 @@
-export { C as CMSApiRouter, a as CMSRouteKey, b as CMS_QUERY_KEYS, c as cmsBackendPlugin, d as createCMSQueryKeys } from '../shared/plugin-cms.DQLAoogy.js';
+export { C as CMSApiRouter, a as CMSRouteKey, b as CMS_QUERY_KEYS, c as cmsBackendPlugin, d as createCMSQueryKeys } from '../shared/plugin-cms.DlUSv7wz.js';
+import { CMSReadView, CMSContentFields, CMSReadOptions, CMSContentItemResult, CMSPublicationPolicy, SerializedContentType, ContentItem, SerializedContentItem, ContentItemWithType, SerializedContentItemWithType, ContentType, ContentRevision } from '../types.js';
+export { CMSBackendConfig, CMSBackendHooks, CMSCreateOperationContext, CMSCreateResultContext, CMSDeleteOperationContext, CMSDeleteResultContext, CMSOperationErrorContext, CMSOperationLifecycleContext, CMSSelectedData, CMSUpdateOperationContext, CMSUpdateResultContext, ContentTypeConfig, PaginatedContentItems, SerializedContentItemContent, SerializedContentRevision } from '../types.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';
@@ -69,7 +69,7 @@ declare function getAllContentItems<TView extends CMSReadView = undefined, const
     limit?: number;
     offset?: number;
     search?: string;
-} & CMSReadOptions<TView, TFields>): Promise<{
+} & CMSReadOptions<TView, TFields>, publication?: CMSPublicationPolicy): Promise<{
     items: CMSContentItemResult<Record<string, unknown>, TView, TFields>[];
     total: number;
     limit?: number;
@@ -86,7 +86,7 @@ declare function getAllContentItems<TView extends CMSReadView = undefined, const
  * @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>;
+declare function getContentItemById<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, id: string, options?: CMSReadOptions<TView, TFields>, publication?: CMSPublicationPolicy): 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.
@@ -99,7 +99,7 @@ declare function getContentItemById<TView extends CMSReadView = undefined, const
  * @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>;
+declare function getContentItemBySlug<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, slug: string, options?: CMSReadOptions<TView, TFields>, publication?: CMSPublicationPolicy): 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. */
@@ -131,7 +131,7 @@ interface ContentItemsByRelationResult<TView extends CMSReadView = undefined, TF
  * 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 function getContentItemsByRelation<TView extends CMSReadView = undefined, const TFields extends CMSContentFields = undefined>(adapter: DBAdapter, contentTypeSlug: string, params: ContentItemsByRelationParams<TView, TFields>, publication?: CMSPublicationPolicy): Promise<ContentItemsByRelationResult<TView, TFields>>;
 
 declare const CMSContentTypeParamsSchema: z.ZodObject<{
     slug: z.ZodString;
@@ -143,10 +143,12 @@ declare const CMSContentItemParamsSchema: z.ZodObject<{
 declare const CMSCreateContentItemBodySchema: z.ZodObject<{
     slug: z.ZodString;
     data: z.ZodType<Record<string, any>, unknown, z.core.$ZodTypeInternals<Record<string, any>, unknown>>;
+    publishAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
 }, 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>>>;
+    publishAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
 }, z.core.$strip>;
 
 /**
@@ -157,7 +159,14 @@ interface CreateCMSContentItemInput {
     slug: string;
     /** Arbitrary data payload — should match the content type schema */
     data: Record<string, unknown>;
+    /** Optional scheduled publication timestamp. */
+    publishAt?: Date | null;
 }
+/**
+ * Append a snapshot; caller owns authorization, validation, lifecycle hooks, and
+ * the transaction containing the item write. Revision rows are never updated.
+ */
+declare function recordContentRevision(adapter: Omit<DBAdapter, "transaction">, item: ContentItem, authorId?: string): Promise<ContentRevision>;
 /**
  * Options for {@link createCMSContentItem}.
  */
@@ -205,5 +214,5 @@ interface CreateCMSContentItemOptions {
  */
 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 { CMSContentFields, CMSContentItemParamsSchema, CMSContentItemResult, CMSContentTypeParamsSchema, CMSCreateContentItemBodySchema, CMSPublicationPolicy, CMSReadOptions, CMSReadView, CMSUpdateContentItemBodySchema, CMS_LIFECYCLE_HOOK_MIGRATIONS, ContentRevision, createCMSContentItem, getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, getContentItemsByRelation, recordContentRevision, serializeContentItem, serializeContentItemWithType, serializeContentType };
 export type { ContentItemsByRelationParams, ContentItemsByRelationResult, CreateCMSContentItemInput, CreateCMSContentItemOptions };

package/dist/api/index.mjs

@@ -1,6 +1,6 @@
 export { cmsBackendPlugin } from './plugin.mjs';
 export { getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, getContentItemsByRelation, serializeContentItem, serializeContentItemWithType, serializeContentType } from './getters.mjs';
-export { createCMSContentItem } from './mutations.mjs';
+export { createCMSContentItem, recordContentRevision } 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';