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

package/dist/client/index.d.ts

@@ -4,12 +4,30 @@ import * as _btst_yar from '@btst/yar';
 import * as react from 'react';
 import { ComponentType } from 'react';
 import { D as DashboardPageComponent } from '../shared/plugin-cms.BBshPRkb.js';
-import { ContentTypeConfig } from '../types.js';
+import { SerializedContentType, ContentTypeConfig } from '../types.js';
 export { CMSContentFields, CMSContentItemResult, CMSReadOptions, CMSReadView, CMSSelectedData, PaginatedContentItems, SerializedContentItemContent } from '../types.js';
 import { ControllerRenderProps, FieldValues } from 'react-hook-form';
 import * as z from 'zod';
 import { z as z$1 } from 'zod';
 
+/** Content supplied to a CMS empty-state presentation. */
+interface EmptyStateProps {
+    title: string;
+    description?: string;
+    action?: React.ReactNode;
+}
+
+/** Display data and navigation supplied by the CMS dashboard. */
+interface ContentTypeCardProps {
+    contentType: SerializedContentType & {
+        itemCount: number;
+    };
+    itemCountLabel: string;
+    onOpen: () => void;
+    className?: string;
+    titleClassName?: string;
+}
+
 declare const CMS_LOCALIZATION: {
     CMS_RELATION_LOADING: string;
     CMS_RELATION_SELECT_PLACEHOLDER: string;
@@ -93,6 +111,15 @@ declare const CMS_LOCALIZATION: {
 };
 type CMSLocalization = typeof CMS_LOCALIZATION;
 
+/** A single visibility condition against a sibling field's value. */
+type ShowIfCondition = {
+    field: string;
+    operator: "equals" | "notEquals" | "in" | "isTruthy";
+    value?: unknown;
+};
+
+declare function AutoFormFile({ field, fieldProps, fieldConfigItem, label, isRequired }: AutoFormInputComponentProps): react.JSX.Element;
+
 declare function AutoFormCheckbox({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react.JSX.Element;
 
 declare function AutoFormDate({ label, isRequired, field, fieldConfigItem, fieldProps, zodItem, }: AutoFormInputComponentProps): react.JSX.Element;
@@ -110,6 +137,7 @@ declare function AutoFormSwitch({ label, isRequired, field, fieldConfigItem, fie
 declare function AutoFormTextarea({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react.JSX.Element;
 
 declare const INPUT_COMPONENTS: {
+    file: typeof AutoFormFile;
     checkbox: typeof AutoFormCheckbox;
     date: typeof AutoFormDate;
     select: typeof AutoFormEnum;
@@ -173,6 +201,10 @@ type FieldInputProps = SerializableInputProps & Omit<React.InputHTMLAttributes<H
  * so that JSON Schema properties can be easily converted to field configs.
  */
 type FieldConfigItem = {
+    /** Show this field only when the condition matches. */
+    showIf?: ShowIfCondition;
+    /** Standalone file upload handler; resolves to a stored URL. */
+    onUpload?: (file: File) => Promise<string>;
     /** Description text or React node */
     description?: React.ReactNode;
     /** Input props passed to the field component */
@@ -238,6 +270,22 @@ interface RouteContext {
  * plugin-specific components and behavior.
  */
 interface CMSPluginOverrides {
+    /** Presentation scoped to built-in route keys. */
+    pageOverrides?: {
+        dashboard?: {
+            ContentTypeCard?: ComponentType<ContentTypeCardProps>;
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+        contentList?: {
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+        newContent?: {
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+        editContent?: {
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+    };
     /**
      * Function used to upload a new image file and return its URL.
      * Used by the default "file" field component when not selecting an existing
@@ -542,6 +590,8 @@ declare const cmsClientPlugin: (config?: CMSClientConfig) => _btst_stack_client.
 interface FormStep {
     id: string;
     title: string;
+    /** Display this step only when its condition matches. */
+    showIf?: ShowIfCondition;
 }
 interface FormSchemaMetadata {
     /** Multi-step form step definitions */
@@ -555,6 +605,9 @@ interface JsonSchemaProperty {
     formatMinimum?: string;
     formatMaximum?: string;
     stepGroup?: number;
+    showIf?: ShowIfCondition;
+    items?: JsonSchemaProperty;
+    required?: string[];
     properties?: Record<string, JsonSchemaProperty>;
     [key: string]: unknown;
 }
@@ -651,4 +704,4 @@ interface CMSFileUploadProps extends AutoFormInputComponentProps {
 declare function CMSFileUpload({ label, isRequired, fieldConfigItem, fieldProps, field, uploadImage, imageInputField: ImageInputField, imagePicker: ImagePickerTrigger, }: CMSFileUploadProps): react.JSX.Element;
 
 export { CMSFileUpload, ContentTypeConfig, cmsClientPlugin, formSchemaToZod, getStepGroupMap, getSteps, hasSteps, zodToFormSchema };
-export type { AutoFormInputComponentProps, CMSClientConfig, CMSClientHooks, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, CMSProviderConfig, FormSchemaMetadata, FormStep, LoaderContext, RouteContext };
+export type { AutoFormInputComponentProps, CMSClientConfig, CMSClientHooks, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, CMSProviderConfig, ContentTypeCardProps, EmptyStateProps, FormSchemaMetadata, FormStep, LoaderContext, RouteContext };

package/dist/db.cjs

@@ -65,6 +65,10 @@ const cmsSchema = db.createDbPlugin("cms", {
         type: "string",
         required: false
       },
+      publishAt: {
+        type: "date",
+        required: false
+      },
       createdAt: {
         type: "date",
         defaultValue: () => /* @__PURE__ */ new Date()
@@ -75,6 +79,27 @@ const cmsSchema = db.createDbPlugin("cms", {
       }
     }
   },
+  contentRevision: {
+    modelName: "contentRevision",
+    fields: {
+      contentItemId: {
+        type: "string",
+        required: true,
+        references: {
+          model: "contentItem",
+          field: "id",
+          onDelete: "cascade"
+        }
+      },
+      revisionKey: { type: "string", required: true, unique: true },
+      version: { type: "number", required: true },
+      slug: { type: "string", required: true },
+      data: { type: "string", required: true },
+      publishAt: { type: "date", required: false },
+      authorId: { type: "string", required: false },
+      createdAt: { type: "date", defaultValue: () => /* @__PURE__ */ new Date() }
+    }
+  },
   /**
    * Junction table for content item relationships
    * Stores many-to-many and one-to-many relations between content items

package/dist/db.mjs

@@ -63,6 +63,10 @@ const cmsSchema = createDbPlugin("cms", {
         type: "string",
         required: false
       },
+      publishAt: {
+        type: "date",
+        required: false
+      },
       createdAt: {
         type: "date",
         defaultValue: () => /* @__PURE__ */ new Date()
@@ -73,6 +77,27 @@ const cmsSchema = createDbPlugin("cms", {
       }
     }
   },
+  contentRevision: {
+    modelName: "contentRevision",
+    fields: {
+      contentItemId: {
+        type: "string",
+        required: true,
+        references: {
+          model: "contentItem",
+          field: "id",
+          onDelete: "cascade"
+        }
+      },
+      revisionKey: { type: "string", required: true, unique: true },
+      version: { type: "number", required: true },
+      slug: { type: "string", required: true },
+      data: { type: "string", required: true },
+      publishAt: { type: "date", required: false },
+      authorId: { type: "string", required: false },
+      createdAt: { type: "date", defaultValue: () => /* @__PURE__ */ new Date() }
+    }
+  },
   /**
    * Junction table for content item relationships
    * Stores many-to-many and one-to-many relations between content items

package/dist/permissions.cjs

@@ -18,6 +18,8 @@ const cmsPermissions = authorization.definePermissions("cms", {
       z.z.object({
         contentType: z.z.string(),
         scope: z.z.enum(["collection", "record"]),
+        /** Set only for publication-filtered content projections; absent for editor/legacy reads. */
+        view: z.z.literal("content").optional(),
         recordId: z.z.string().optional(),
         authorId: z.z.string().optional()
       })

package/dist/permissions.d.cts

@@ -17,6 +17,7 @@ declare const cmsPermissions: _btst_stack_authorization.PermissionCatalog<"cms",
                 record: "record";
                 collection: "collection";
             }>;
+            view: z.ZodOptional<z.ZodLiteral<"content">>;
             recordId: z.ZodOptional<z.ZodString>;
             authorId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;

package/dist/permissions.d.mts

@@ -17,6 +17,7 @@ declare const cmsPermissions: _btst_stack_authorization.PermissionCatalog<"cms",
                 record: "record";
                 collection: "collection";
             }>;
+            view: z.ZodOptional<z.ZodLiteral<"content">>;
             recordId: z.ZodOptional<z.ZodString>;
             authorId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;

package/dist/permissions.d.ts

@@ -17,6 +17,7 @@ declare const cmsPermissions: _btst_stack_authorization.PermissionCatalog<"cms",
                 record: "record";
                 collection: "collection";
             }>;
+            view: z.ZodOptional<z.ZodLiteral<"content">>;
             recordId: z.ZodOptional<z.ZodString>;
             authorId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;

package/dist/permissions.mjs

@@ -16,6 +16,8 @@ const cmsPermissions = definePermissions("cms", {
       z.object({
         contentType: z.string(),
         scope: z.enum(["collection", "record"]),
+        /** Set only for publication-filtered content projections; absent for editor/legacy reads. */
+        view: z.literal("content").optional(),
         recordId: z.string().optional(),
         authorId: z.string().optional()
       })

package/dist/query-keys.cjs

@@ -75,6 +75,33 @@ const cmsResources = {
       }
     }
   },
+  cmsRevisions: {
+    queries: {
+      list: {
+        path: "/content/:typeSlug/:id/revisions",
+        params: (typeSlug, id) => ({ typeSlug, id }),
+        key: (typeSlug, id) => [typeSlug, id],
+        select: (data) => data ?? { items: [], total: 0 },
+        infinite: true,
+        pageSize: () => 20,
+        nextPageParam: (lastPage, allPages) => paginatedNextPageParam(lastPage, allPages, 20)
+      }
+    },
+    mutations: {
+      restore: {
+        path: "@post/content/:typeSlug/:id/revisions/:revisionId/restore",
+        method: "POST",
+        input: (vars) => ({ params: vars }),
+        select: (data) => data,
+        invalidates: [
+          "cmsContent",
+          "cmsRevisions",
+          "cmsTypes.inverseRelationItems",
+          "cmsTypes.inverseRelations"
+        ]
+      }
+    }
+  },
   cmsContent: {
     queries: {
       list: {
@@ -175,11 +202,12 @@ const cmsResources = {
         method: "POST",
         input: (vars) => ({
           params: { typeSlug: vars.typeSlug },
-          body: { slug: vars.slug, data: vars.data }
+          body: { slug: vars.slug, data: vars.data, publishAt: vars.publishAt }
         }),
         select: (data) => data,
         invalidates: [
           "cmsContent",
+          "cmsRevisions",
           "cmsTypes.list",
           "cmsTypes.inverseRelationItems",
           "cmsTypes.inverseRelations"
@@ -195,6 +223,7 @@ const cmsResources = {
         select: (data) => data,
         invalidates: [
           "cmsContent",
+          "cmsRevisions",
           "cmsTypes.inverseRelationItems",
           "cmsTypes.inverseRelations"
         ],
@@ -212,6 +241,7 @@ const cmsResources = {
         select: (data) => data,
         invalidates: [
           "cmsContent",
+          "cmsRevisions",
           "cmsTypes.list",
           "cmsTypes.inverseRelationItems",
           "cmsTypes.inverseRelations"

package/dist/query-keys.d.cts

@@ -1,4 +1,4 @@
-export { e as ContentListDiscriminator, f as ContentListParams, g as cmsResources, h as contentListDiscriminator, d as createCMSQueryKeys } from './shared/plugin-cms.c-GeWvTf.cjs';
+export { e as ContentListDiscriminator, f as ContentListParams, g as cmsResources, h as contentListDiscriminator, d as createCMSQueryKeys } from './shared/plugin-cms.DJ_293QU.cjs';
 import '@btst/stack/plugins/client';
 import './types.cjs';
 import '@btst/stack/authorization';

package/dist/query-keys.d.mts

@@ -1,4 +1,4 @@
-export { e as ContentListDiscriminator, f as ContentListParams, g as cmsResources, h as contentListDiscriminator, d as createCMSQueryKeys } from './shared/plugin-cms.W4Le8D91.mjs';
+export { e as ContentListDiscriminator, f as ContentListParams, g as cmsResources, h as contentListDiscriminator, d as createCMSQueryKeys } from './shared/plugin-cms.DAAUZ41w.mjs';
 import '@btst/stack/plugins/client';
 import './types.mjs';
 import '@btst/stack/authorization';

package/dist/query-keys.d.ts

@@ -1,4 +1,4 @@
-export { e as ContentListDiscriminator, f as ContentListParams, g as cmsResources, h as contentListDiscriminator, d as createCMSQueryKeys } from './shared/plugin-cms.DQLAoogy.js';
+export { e as ContentListDiscriminator, f as ContentListParams, g as cmsResources, h as contentListDiscriminator, d as createCMSQueryKeys } from './shared/plugin-cms.DlUSv7wz.js';
 import '@btst/stack/plugins/client';
 import './types.js';
 import '@btst/stack/authorization';

package/dist/query-keys.mjs

@@ -73,6 +73,33 @@ const cmsResources = {
       }
     }
   },
+  cmsRevisions: {
+    queries: {
+      list: {
+        path: "/content/:typeSlug/:id/revisions",
+        params: (typeSlug, id) => ({ typeSlug, id }),
+        key: (typeSlug, id) => [typeSlug, id],
+        select: (data) => data ?? { items: [], total: 0 },
+        infinite: true,
+        pageSize: () => 20,
+        nextPageParam: (lastPage, allPages) => paginatedNextPageParam(lastPage, allPages, 20)
+      }
+    },
+    mutations: {
+      restore: {
+        path: "@post/content/:typeSlug/:id/revisions/:revisionId/restore",
+        method: "POST",
+        input: (vars) => ({ params: vars }),
+        select: (data) => data,
+        invalidates: [
+          "cmsContent",
+          "cmsRevisions",
+          "cmsTypes.inverseRelationItems",
+          "cmsTypes.inverseRelations"
+        ]
+      }
+    }
+  },
   cmsContent: {
     queries: {
       list: {
@@ -173,11 +200,12 @@ const cmsResources = {
         method: "POST",
         input: (vars) => ({
           params: { typeSlug: vars.typeSlug },
-          body: { slug: vars.slug, data: vars.data }
+          body: { slug: vars.slug, data: vars.data, publishAt: vars.publishAt }
         }),
         select: (data) => data,
         invalidates: [
           "cmsContent",
+          "cmsRevisions",
           "cmsTypes.list",
           "cmsTypes.inverseRelationItems",
           "cmsTypes.inverseRelations"
@@ -193,6 +221,7 @@ const cmsResources = {
         select: (data) => data,
         invalidates: [
           "cmsContent",
+          "cmsRevisions",
           "cmsTypes.inverseRelationItems",
           "cmsTypes.inverseRelations"
         ],
@@ -210,6 +239,7 @@ const cmsResources = {
         select: (data) => data,
         invalidates: [
           "cmsContent",
+          "cmsRevisions",
           "cmsTypes.list",
           "cmsTypes.inverseRelationItems",
           "cmsTypes.inverseRelations"