@webiny/api-headless-cms 0.0.0-mt-3 → 0.0.0-unstable.8c4d9f045a

package/types.d.ts

@@ -1,20 +1,20 @@
 import { Plugin } from "@webiny/plugins/types";
 import { I18NContext, I18NLocale } from "@webiny/api-i18n/types";
-import { ContextInterface } from "@webiny/handler/types";
+import { Context } from "@webiny/api/types";
 import { TenancyContext } from "@webiny/api-tenancy/types";
 import { GraphQLFieldResolver, GraphQLSchemaDefinition, Resolvers } from "@webiny/handler-graphql/types";
-import { BaseI18NContentContext } from "@webiny/api-i18n-content/types";
 import { SecurityPermission } from "@webiny/api-security/types";
-import { HttpContext } from "@webiny/handler-http/types";
 import { DbContext } from "@webiny/handler-db/types";
 import { FileManagerContext } from "@webiny/api-file-manager/types";
 import { UpgradePlugin } from "@webiny/api-upgrade/types";
 import { Topic } from "@webiny/pubsub/types";
+import { CmsModelConverterCallable } from "./utils/converters/ConverterCollection";
+export declare type ApiEndpoint = "manage" | "preview" | "read";
 export interface HeadlessCms extends CmsSettingsContext, CmsSystemContext, CmsGroupContext, CmsModelContext, CmsEntryContext {
     /**
      * API type
      */
-    type: "manage" | "preview" | "read" | string;
+    type: ApiEndpoint | null;
     /**
      * Requested locale
      */
@@ -45,12 +45,16 @@ export interface HeadlessCms extends CmsSettingsContext, CmsSystemContext, CmsGr
  *
  * @category Context
  */
-export interface CmsContext extends ContextInterface, DbContext, HttpContext, I18NContext, FileManagerContext, BaseI18NContentContext, TenancyContext {
+export interface CmsContext extends Context, DbContext, I18NContext, FileManagerContext, TenancyContext {
     cms: HeadlessCms;
 }
 interface CmsModelFieldPredefinedValuesValue {
     value: string;
     label: string;
+    /**
+     * Default selected predefined value.
+     */
+    selected?: boolean;
 }
 /**
  * Object containing content model field predefined options and values.
@@ -79,6 +83,39 @@ interface CmsModelFieldRenderer {
      */
     name: string;
 }
+/**
+ * A definition for content model field settings.
+ *
+ * @category ModelField
+ * @category Database model
+ */
+export interface CmsModelFieldSettings {
+    /**
+     * Predefined values (text, number)
+     * The default value for the field in case it is not predefined values field.
+     */
+    defaultValue?: string | number | null | undefined;
+    /**
+     * Object field has child fields.
+     */
+    fields?: CmsModelField[];
+    /**
+     * Object field has child fields - so it needs to have a layout.
+     */
+    layout?: string[][];
+    /**
+     * Ref field.
+     */
+    models?: Pick<CmsModel, "modelId">[];
+    /**
+     * Date field.
+     */
+    type?: string;
+    /**
+     * There are a lot of other settings that are possible to add, so we keep the type opened.
+     */
+    [key: string]: any;
+}
 /**
  * A definition for content model field. This type exists on the app side as well.
  *
@@ -87,15 +124,37 @@ interface CmsModelFieldRenderer {
  */
 export interface CmsModelField {
     /**
-     * A generated ID for the model field
+     * A generated unique ID for the model field.
+     * MUST be absolute unique throughout the models.
+     * Must be in form of a-zA-Z0-9.
+     *
+     * We generate a unique id value when you're building a model via UI,
+     * but when user is creating a model via a plugin it is up to them to be careful about this.
      */
     id: string;
     /**
-     * A type of the field
+     * A type of the field.
+     * We are defining our built-in fields, so people know which are available by the default.
      */
-    type: string;
+    type: "boolean" | "datetime" | "file" | "long-text" | "number" | "object" | "ref" | "rich-text" | "text" | string;
     /**
-     * A unique field ID for mapping values
+     * A unique storage ID for storing actual values.
+     * Must in form of a-zA-Z0-9@a-zA-Z0-9@a-zA-Z0-9.
+     *
+     * This is an auto-generated value: uses `id` and `type`
+     *
+     * This is used as path for the entry value.
+     *
+     * @internal
+     */
+    storageId: string;
+    /**
+     * Field identifier for the model field that will be available to the outside world.
+     * `storageId` is used as path (or column) to store the data.
+     *
+     * Must in form of a-zA-Z0-9.
+     *
+     * This value MUST be unique in the CmsModel.
      */
     fieldId: string;
     /**
@@ -105,11 +164,11 @@ export interface CmsModelField {
     /**
      * Text below the field to clarify what is it meant to be in the field value
      */
-    helpText?: string;
+    helpText?: string | null;
     /**
      * Text to be displayed in the field
      */
-    placeholderText?: string;
+    placeholderText?: string | null;
     /**
      * Are predefined values enabled? And list of them
      */
@@ -142,9 +201,13 @@ export interface CmsModelField {
      *
      * @default {}
      */
-    settings?: {
-        [key: string]: any;
-    };
+    settings?: CmsModelFieldSettings;
+}
+/**
+ * Used for our internal functionality.
+ */
+export interface CmsModelFieldWithParent extends CmsModelField {
+    parent?: CmsModelFieldWithParent | null;
 }
 /**
  * A definition for dateTime field to show possible type of the field in settings.
@@ -163,11 +226,11 @@ export interface CmsModelDateTimeField extends CmsModelField {
  * @category ModelField
  * @category FieldValidation
  */
-export interface CmsModelFieldValidatorValidateParams {
+export interface CmsModelFieldValidatorValidateParams<T = any> {
     /**
      * A value to be validated.
      */
-    value: any;
+    value: T;
     /**
      * Options from the CmsModelField validations.
      *
@@ -186,7 +249,12 @@ export interface CmsModelFieldValidatorValidateParams {
     /**
      * An instance of the content model being validated.
      */
-    contentModel: CmsModel;
+    model: CmsModel;
+    /**
+     * If entry is sent it means it is an update operation.
+     * First usage is for the unique field value.
+     */
+    entry?: CmsEntry;
 }
 /**
  * Definition for the field validator.
@@ -253,7 +321,8 @@ export interface CmsModelFieldPatternValidatorPlugin extends Plugin {
  */
 export interface LockedField {
     /**
-     * Locked field ID - one used for mapping values.
+     * Locked field storage ID - one used to store values.
+     * We cannot change this due to old systems.
      */
     fieldId: string;
     /**
@@ -281,6 +350,10 @@ export interface CmsModel {
      * Unique ID for the content model. Created from name if not defined by user.
      */
     modelId: string;
+    /**
+     * Model tenant.
+     */
+    tenant: string;
     /**
      * Locale this model belongs to.
      */
@@ -301,15 +374,15 @@ export interface CmsModel {
     /**
      * Description for the content model.
      */
-    description?: string;
+    description: string;
     /**
      * Date created
      */
-    createdOn?: Date;
+    createdOn?: string;
     /**
      * Date saved. Changes on both save and create.
      */
-    savedOn?: Date;
+    savedOn?: string;
     /**
      * CreatedBy object wrapper. Contains id, name and type of the user.
      */
@@ -343,9 +416,20 @@ export interface CmsModel {
      */
     webinyVersion: string;
     /**
-     * Model tenant.
+     * Is model private?
+     * This is meant to be used for some internal models - will not be visible in the schema.
+     * Only available for the plugin constructed models.
      */
-    tenant: string;
+    isPrivate?: boolean;
+}
+/**
+ * When sending model to the storage operations, it must contain createValueKeyToStorageConverter and createValueKeyFromStorageConverter
+ *
+ * @category CmsModel
+ */
+export interface StorageOperationsCmsModel extends CmsModel {
+    convertValueKeyToStorage: CmsModelConverterCallable;
+    convertValueKeyFromStorage: CmsModelConverterCallable;
 }
 /**
  * @category ModelField
@@ -354,17 +438,18 @@ export interface CmsModelFieldDefinition {
     fields: string;
     typeDefs?: string;
 }
+interface CmsModelFieldToGraphQLCreateResolverParams {
+    models: CmsModel[];
+    model: CmsModel;
+    graphQLType: string;
+    field: CmsModelField;
+    createFieldResolvers: any;
+}
 export interface CmsModelFieldToGraphQLCreateResolver {
-    (params: {
-        models: CmsModel[];
-        model: CmsModel;
-        graphQLType: string;
-        field: CmsModelField;
-        createFieldResolvers: any;
-    }): GraphQLFieldResolver | {
-        resolver: GraphQLFieldResolver;
+    (params: CmsModelFieldToGraphQLCreateResolverParams): GraphQLFieldResolver | {
+        resolver: GraphQLFieldResolver | null;
         typeResolvers: Resolvers<CmsContext>;
-    };
+    } | false;
 }
 /**
  * @category Plugin
@@ -392,6 +477,15 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
      * ```
      */
     isSearchable: boolean;
+    /**
+     * Is the field searchable via full text search?
+     *
+     * Field is not full text searchable by default.
+     * ```ts
+     * fullTextSearch: false
+     * ```
+     */
+    fullTextSearch?: boolean;
     /**
      * Is the field sortable via the GraphQL?
      *
@@ -400,6 +494,27 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
      * ```
      */
     isSortable: boolean;
+    /**
+     * Optional method which creates the storageId.
+     * Primary use is for the datetime field, but if users has some specific fields, they can customize the storageId to their needs.
+     *
+     * ```ts
+     * createStorageId: ({field}) => {
+     *     if (field.settings.type === "time) {
+     *         return `${field.type}_time@${field.id}`
+     *     }
+     *     // use default method
+     *     return undefined;
+     * }
+     * ```
+     */
+    createStorageId?: (params: {
+        model: CmsModel;
+        field: CmsModelField;
+    }) => string | null | undefined;
+    /**
+     * Read API methods.
+     */
     read: {
         /**
          * Definition for get filtering for GraphQL.
@@ -455,16 +570,16 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
             model: CmsModel;
             field: CmsModelField;
             fieldTypePlugins: CmsFieldTypePlugins;
-        }): CmsModelFieldDefinition | string;
+        }): CmsModelFieldDefinition | string | null;
         /**
          * Definition for field resolver.
-         * By default it is simple return of the `instance.values[fieldId]` but if required, users can define their own.
+         * By default it is simple return of the `instance.values[storageId]` but if required, users can define their own.
          *
          * ```ts
          * read: {
          *     createResolver({ field }) {
          *         return instance => {
-         *             return instance.values[field.fieldId];
+         *             return instance.values[field.storageId];
          *         };
          *     }
          * }
@@ -492,7 +607,6 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          */
         createSchema?: (params: {
             models: CmsModel[];
-            model: CmsModel;
         }) => GraphQLSchemaDefinition<CmsContext>;
     };
     manage: {
@@ -535,7 +649,6 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          */
         createSchema?: (params: {
             models: CmsModel[];
-            model: CmsModel;
         }) => GraphQLSchemaDefinition<CmsContext>;
         /**
          * Definition of the field type for GraphQL - be aware if multiple values is selected. Probably same as `read.createTypeField`.
@@ -556,7 +669,7 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
             model: CmsModel;
             field: CmsModelField;
             fieldTypePlugins: CmsFieldTypePlugins;
-        }) => CmsModelFieldDefinition | string;
+        }) => CmsModelFieldDefinition | string | null;
         /**
          * Definition for input GraphQL field type.
          *
@@ -576,16 +689,16 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
             model: CmsModel;
             field: CmsModelField;
             fieldTypePlugins: CmsFieldTypePlugins;
-        }) => CmsModelFieldDefinition | string;
+        }) => CmsModelFieldDefinition | string | null;
         /**
          * Definition for field resolver.
-         * By default it is simple return of the `instance.values[fieldId]` but if required, users can define their own.
+         * By default it is simple return of the `instance.values[storageId]` but if required, users can define their own.
          *
          * ```ts
          * manage: {
          *     createResolver({ field }) {
          *         return instance => {
-         *             return instance.values[field.fieldId];
+         *             return instance.values[field.storageId];
          *         };
          *     }
          * }
@@ -643,7 +756,7 @@ export interface CreatedBy {
     /**
      * Full name of the user.
      */
-    displayName: string;
+    displayName: string | null;
     /**
      * Type of the user (admin, user)
      */
@@ -689,14 +802,16 @@ export interface CmsSettingsContext {
 }
 export interface BeforeInstallTopicParams {
     tenant: string;
+    locale: string;
 }
 export interface AfterInstallTopicParams {
     tenant: string;
+    locale: string;
 }
 export declare type CmsSystemContext = {
-    getSystemVersion: () => Promise<string>;
+    getSystemVersion: () => Promise<string | null>;
     setSystemVersion: (version: string) => Promise<void>;
-    getReadAPIKey(): Promise<string>;
+    getReadAPIKey(): Promise<string | null>;
     installSystem: () => Promise<void>;
     upgradeSystem: (version: string) => Promise<boolean>;
     /**
@@ -748,6 +863,10 @@ export interface CmsGroup {
      * Slug for the group. Must be unique.
      */
     slug: string;
+    /**
+     * Group tenant.
+     */
+    tenant: string;
     /**
      * Locale this group belongs to.
      */
@@ -755,11 +874,11 @@ export interface CmsGroup {
     /**
      * Description for the group.
      */
-    description?: string;
+    description: string;
     /**
      * Icon for the group. In a form of "ico/ico".
      */
-    icon?: string;
+    icon: string;
     /**
      * CreatedBy reference object.
      */
@@ -777,9 +896,11 @@ export interface CmsGroup {
      */
     webinyVersion: string;
     /**
-     * Group tenant.
+     * Is group private?
+     * This is meant to be used for some internal groups - will not be visible in the schema.
+     * Only available for the plugin constructed groups.
      */
-    tenant: string;
+    isPrivate?: boolean;
 }
 /**
  * A data.where parameter received when listing content model groups.
@@ -865,6 +986,10 @@ export interface CmsGroupContext {
      * Delete content model group by given id.
      */
     deleteGroup: (id: string) => Promise<boolean>;
+    /**
+     * Clear the cached groups.
+     */
+    clearGroupsCache: () => void;
     /**
      * Events.
      */
@@ -884,7 +1009,12 @@ export interface CmsGroupContext {
 export interface CmsModelFieldValidation {
     name: string;
     message: string;
-    settings?: Record<string, any>;
+    settings?: {
+        value?: string | number;
+        values?: string[];
+        preset?: string;
+        [key: string]: any;
+    };
 }
 /**
  * A GraphQL params.data parameter received when creating content model.
@@ -905,6 +1035,42 @@ export interface CmsModelCreateInput {
      * Description of the content model.
      */
     description?: string;
+    /**
+     * Group where to put the content model in.
+     */
+    group: string;
+    /**
+     * A list of content model fields to define the entry values.
+     */
+    fields?: CmsModelFieldInput[];
+    /**
+     * Admin UI field layout
+     *
+     * ```ts
+     * layout: [
+     *      [field1id, field2id],
+     *      [field3id]
+     * ]
+     * ```
+     */
+    layout?: string[][];
+    /**
+     * The field that is being displayed as entry title.
+     * It is picked as first available text field. Or user can select own field.
+     */
+    titleFieldId?: string;
+}
+/**
+ * A GraphQL params.data parameter received when creating content model from existing model.
+ *
+ * @category GraphQL params
+ * @category CmsModel
+ */
+export interface CmsModelCreateFromInput extends CmsModelCreateInput {
+    /**
+     * Locale into which we want to clone the model into.
+     */
+    locale?: string;
 }
 /**
  * A definition for content model field received from the user.
@@ -926,7 +1092,7 @@ export interface CmsModelFieldInput {
      */
     type: string;
     /**
-     * A unique ID for the field. Values will be mapped via this value.
+     * Field outside world identifier for the field. Must be unique in the model.
      */
     fieldId: string;
     /**
@@ -977,6 +1143,10 @@ export interface CmsModelUpdateInput {
      * A new content model name.
      */
     name?: string;
+    /**
+     * A group we want to move the model to.
+     */
+    group?: string;
     /**
      * A new description of the content model.
      */
@@ -1027,6 +1197,15 @@ export interface ModelManagerPlugin extends Plugin {
      */
     create: (context: CmsContext, model: CmsModel) => Promise<CmsModelManager>;
 }
+/**
+ * A content entry values definition for and from the database.
+ *
+ * @category Database model
+ * @category CmsEntry
+ */
+export interface CmsEntryValues {
+    [key: string]: any;
+}
 /**
  * A content entry definition for and from the database.
  *
@@ -1098,11 +1277,22 @@ export interface CmsEntry {
      */
     status: CmsEntryStatus;
     /**
-     * A mapped fieldId -> value object.
+     * A mapped storageId -> value object.
      *
      * @see CmsModelField
      */
-    values: Record<string, any>;
+    values: CmsEntryValues;
+    /**
+     * Settings for the given entry.
+     *
+     * Introduced with Advanced Publishing Workflow - will be always inserted after this PR is merged.
+     * Be aware that when accessing properties in it on old systems - it will break if not checked first.
+     *
+     * Available only on the Manage API in entry GraphQL type meta.data property.
+     */
+    meta?: {
+        [key: string]: any;
+    };
 }
 export interface CmsStorageEntry extends CmsEntry {
     [key: string]: any;
@@ -1118,18 +1308,14 @@ export interface CmsStorageEntry extends CmsEntry {
  * @category CmsModel
  */
 export interface CmsModelManager {
-    /**
-     * List entries in this content model.
-     */
-    list: (params?: CmsEntryListParams) => Promise<[CmsEntry[], CmsEntryMeta]>;
     /**
      * List only published entries in the content model.
      */
-    listPublished: (params?: CmsEntryListParams) => Promise<[CmsEntry[], CmsEntryMeta]>;
+    listPublished: (params: CmsEntryListParams) => Promise<[CmsEntry[], CmsEntryMeta]>;
     /**
      * List latest entries in the content model. Used for administration.
      */
-    listLatest: (params?: CmsEntryListParams) => Promise<[CmsEntry[], CmsEntryMeta]>;
+    listLatest: (params: CmsEntryListParams) => Promise<[CmsEntry[], CmsEntryMeta]>;
     /**
      * Get a list of published entries by the ID list.
      */
@@ -1145,31 +1331,41 @@ export interface CmsModelManager {
     /**
      * Create a entry.
      */
-    create: (data: Record<string, any>) => Promise<CmsEntry>;
+    create: (data: CreateCmsEntryInput) => Promise<CmsEntry>;
     /**
      * Update a entry.
      */
-    update: (id: string, data: Record<string, any>) => Promise<CmsEntry>;
+    update: (id: string, data: UpdateCmsEntryInput) => Promise<CmsEntry>;
     /**
      * Delete a entry.
      */
     delete: (id: string) => Promise<void>;
 }
 export interface BeforeModelCreateTopicParams {
-    input: Partial<CmsModel>;
+    input: CmsModelCreateInput;
     model: CmsModel;
 }
 export interface AfterModelCreateTopicParams {
-    input: Partial<CmsModel>;
+    input: CmsModelCreateInput;
+    model: CmsModel;
+}
+export interface BeforeModelCreateFromTopicParams {
+    input: CmsModelCreateInput;
+    original: CmsModel;
+    model: CmsModel;
+}
+export interface AfterModelCreateFromTopicParams {
+    input: CmsModelCreateInput;
+    original: CmsModel;
     model: CmsModel;
 }
 export interface BeforeModelUpdateTopicParams {
-    input: Partial<CmsModel>;
+    input: CmsModelUpdateInput;
     original: CmsModel;
     model: CmsModel;
 }
 export interface AfterModelUpdateTopicParams {
-    input: Partial<CmsModel>;
+    input: CmsModelUpdateInput;
     original: CmsModel;
     model: CmsModel;
 }
@@ -1190,15 +1386,6 @@ export interface CmsModelUpdateDirectParams {
  * @category CmsModel
  */
 export interface CmsModelContext {
-    /**
-     * A function defining usage of a method with authenticating the user but not throwing an error.
-     */
-    silentAuthModel: () => {
-        /**
-         * Get all content models.
-         */
-        list: () => Promise<CmsModel[]>;
-    };
     /**
      * Get a single content model.
      */
@@ -1211,12 +1398,12 @@ export interface CmsModelContext {
      * Create a content model.
      */
     createModel: (data: CmsModelCreateInput) => Promise<CmsModel>;
+    /**
+     * Create a content model from the given model - clone.
+     */
+    createModelFrom: (modelId: string, data: CmsModelCreateFromInput) => Promise<CmsModel>;
     /**
      * Update content model without data validation. Used internally.
-     *
-     * @param model - existing content model
-     * @param data - data to be updated
-     *
      * @hidden
      */
     updateModelDirect: (params: CmsModelUpdateDirectParams) => Promise<CmsModel>;
@@ -1232,18 +1419,29 @@ export interface CmsModelContext {
      * Get a instance of CmsModelManager for given content modelId.
      *
      * @see CmsModelManager
+     *
+     * @deprecated use the getEntryManager() method instead
      */
-    getModelManager: (modelId: string) => Promise<CmsModelManager>;
+    getModelManager: (model: CmsModel | string) => Promise<CmsModelManager>;
+    getEntryManager: (model: CmsModel | string) => Promise<CmsModelManager>;
     /**
      * Get all content model managers mapped by modelId.
      * @see CmsModelManager
+     * @deprecated use getEntryManagers instead
      */
     getManagers: () => Map<string, CmsModelManager>;
+    getEntryManagers: () => Map<string, CmsModelManager>;
+    /**
+     * Clear all the model caches.
+     */
+    clearModelsCache: () => void;
     /**
      * Events.
      */
     onBeforeModelCreate: Topic<BeforeModelCreateTopicParams>;
     onAfterModelCreate: Topic<AfterModelCreateTopicParams>;
+    onBeforeModelCreateFrom: Topic<BeforeModelCreateFromTopicParams>;
+    onAfterModelCreateFrom: Topic<AfterModelCreateFromTopicParams>;
     onBeforeModelUpdate: Topic<BeforeModelUpdateTopicParams>;
     onAfterModelUpdate: Topic<AfterModelUpdateTopicParams>;
     onBeforeModelDelete: Topic<BeforeModelDeleteTopicParams>;
@@ -1254,7 +1452,17 @@ export interface CmsModelContext {
  *
  * @category CmsEntry
  */
-declare type CmsEntryStatus = "published" | "unpublished" | "reviewRequested" | "changesRequested" | "draft";
+export declare type CmsEntryStatus = "published" | "unpublished" | "reviewRequested" | "changesRequested" | "draft";
+export interface CmsEntryListWhereRef {
+    id?: string;
+    id_in?: string[];
+    id_not?: string;
+    id_not_in?: string[];
+    entryId?: string;
+    entryId_not?: string;
+    entryId_in?: string[];
+    entryId_not_in?: string[];
+}
 /**
  * Entry listing where params.
  *
@@ -1277,7 +1485,9 @@ export interface CmsEntryListWhere {
     entryId_in?: string[];
     entryId_not_in?: string[];
     /**
-     * Entry is owned by whom?
+     * Contains the owner of the entry. An "owner" is the identity who originally created the entry.
+     * Subsequent revisions can be created by other identities, and those will be stored in `createdBy`,
+     * but the `owner` is always the original author of the entry.
      *
      * Can be sent via the API or set internal if user can see only their own entries.
      */
@@ -1302,22 +1512,25 @@ export interface CmsEntryListWhere {
     version_lt?: number;
     version_gt?: number;
     /**
-     * Each operations implementation MUST determine how to use this field.
-     * In SQL it can be published field and in DynamoDB can be a secondary key.
+     * Each storage operations implementation MUST determine how to use this field.
+     * In SQL, it can be a `published` field, and in DynamoDB it can be an SK.
      *
      * It is not meant to be used via the API.
      * @internal
      */
     published?: boolean;
     /**
-     * Each operations implementation MUST determine how to use this field.
-     * In SQL it can be published field and in DynamoDB can be a secondary key.
+     * Each storage operations implementation MUST determine how to use this field.
+     * In SQL, it can be a `latest` field, and in DynamoDB it can be an SK.
      *
      * It is not meant to be used via the API.
      * @internal
      */
     latest?: boolean;
-    [key: string]: any;
+    /**
+     * This is to allow querying by any content model field defined by the user.
+     */
+    [key: string]: any | CmsEntryListWhereRef;
 }
 /**
  * Entry listing sort.
@@ -1343,10 +1556,12 @@ export interface CmsEntryGetParams {
  * @category GraphQL params
  */
 export interface CmsEntryListParams {
-    where: CmsEntryListWhere;
+    where?: CmsEntryListWhere;
     sort?: CmsEntryListSort;
+    search?: string;
+    fields?: string[];
     limit?: number;
-    after?: string;
+    after?: string | null;
 }
 /**
  * Meta information for GraphQL output.
@@ -1358,7 +1573,7 @@ export interface CmsEntryMeta {
     /**
      * A cursor for pagination.
      */
-    cursor: string;
+    cursor: string | null;
     /**
      * Is there more items to load?
      */
@@ -1369,97 +1584,122 @@ export interface CmsEntryMeta {
     totalCount: number;
 }
 export interface BeforeEntryCreateTopicParams {
-    input: Partial<CmsEntry>;
+    input: CreateCmsEntryInput;
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
 export interface AfterEntryCreateTopicParams {
-    input: Partial<CmsEntry>;
+    input: CreateCmsEntryInput;
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
-export interface BeforeEntryRevisionCreateTopicParams {
+export interface BeforeEntryCreateRevisionTopicParams {
+    input: CreateFromCmsEntryInput;
     entry: CmsEntry;
-    model: CmsModel;
+    original: CmsEntry;
+    model: StorageOperationsCmsModel;
 }
-export interface AfterEntryRevisionCreateTopicParams {
+export interface AfterEntryCreateRevisionTopicParams {
+    input: CreateFromCmsEntryInput;
     entry: CmsEntry;
-    model: CmsModel;
+    original: CmsEntry;
+    model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
 export interface BeforeEntryUpdateTopicParams {
-    input: Partial<CmsEntry>;
+    input: UpdateCmsEntryInput;
     original: CmsEntry;
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
 export interface AfterEntryUpdateTopicParams {
-    input: Partial<CmsEntry>;
+    input: UpdateCmsEntryInput;
     original: CmsEntry;
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
 export interface BeforeEntryPublishTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
 export interface AfterEntryPublishTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
 export interface BeforeEntryUnpublishTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
 export interface AfterEntryUnpublishTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
 export interface BeforeEntryRequestChangesTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
 export interface AfterEntryRequestChangesTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
 export interface BeforeEntryRequestReviewTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
 export interface AfterEntryRequestReviewTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
 export interface BeforeEntryDeleteTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
 export interface AfterEntryDeleteTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
-export interface BeforeEntryRevisionDeleteTopicParams {
+export interface BeforeEntryDeleteRevisionTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
-export interface AfterEntryRevisionDeleteTopicParams {
+export interface AfterEntryDeleteRevisionTopicParams {
     entry: CmsEntry;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
 }
 export interface BeforeEntryGetTopicParams {
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
     where: CmsEntryListWhere;
 }
 export interface BeforeEntryListTopicParams {
     where: CmsEntryListWhere;
-    model: CmsModel;
+    model: StorageOperationsCmsModel;
+}
+/**
+ * @category Context
+ * @category CmsEntry
+ */
+export interface CreateCmsEntryInput {
+    [key: string]: any;
+}
+/**
+ * @category Context
+ * @category CmsEntry
+ */
+export interface CreateFromCmsEntryInput {
+    [key: string]: any;
+}
+/**
+ * @category Context
+ * @category CmsEntry
+ */
+export interface UpdateCmsEntryInput {
+    [key: string]: any;
 }
 /**
  * Cms Entry CRUD methods in the context.
@@ -1475,7 +1715,7 @@ export interface CmsEntryContext {
     /**
      * Get a list of entries for a model by a given ID (revision).
      */
-    getEntriesByIds: (model: CmsModel, revisions: string[]) => Promise<CmsEntry[] | null>;
+    getEntriesByIds: (model: CmsModel, revisions: string[]) => Promise<CmsEntry[]>;
     /**
      * Get the entry for a model by a given ID.
      */
@@ -1483,7 +1723,7 @@ export interface CmsEntryContext {
     /**
      * List entries for a model. Internal method used by get, listLatest and listPublished.
      */
-    listEntries: (model: CmsModel, params?: CmsEntryListParams) => Promise<[CmsEntry[], CmsEntryMeta]>;
+    listEntries: (model: CmsModel, params: CmsEntryListParams) => Promise<[CmsEntry[], CmsEntryMeta]>;
     /**
      * Lists latest entries. Used for manage API.
      */
@@ -1503,15 +1743,20 @@ export interface CmsEntryContext {
     /**
      * Create a new content entry.
      */
-    createEntry: (model: CmsModel, data: Record<string, any>) => Promise<CmsEntry>;
+    createEntry: (model: CmsModel, input: CreateCmsEntryInput) => Promise<CmsEntry>;
     /**
      * Create a new entry from already existing entry.
      */
-    createEntryRevisionFrom: (model: CmsModel, id: string, data: Record<string, any>) => Promise<CmsEntry>;
+    createEntryRevisionFrom: (model: CmsModel, id: string, input: CreateFromCmsEntryInput) => Promise<CmsEntry>;
     /**
      * Update existing entry.
      */
-    updateEntry: (model: CmsModel, id: string, data?: Record<string, any>) => Promise<CmsEntry>;
+    updateEntry: (model: CmsModel, id: string, input: UpdateCmsEntryInput, meta?: Record<string, any>) => Promise<CmsEntry>;
+    /**
+     * Method that republishes entry with given identifier.
+     * @internal
+     */
+    republishEntry: (model: CmsModel, id: string) => Promise<CmsEntry>;
     /**
      * Delete only a certain revision of the entry.
      */
@@ -1545,14 +1790,14 @@ export interface CmsEntryContext {
      */
     onBeforeEntryCreate: Topic<BeforeEntryCreateTopicParams>;
     onAfterEntryCreate: Topic<AfterEntryCreateTopicParams>;
-    onBeforeEntryRevisionCreate: Topic<BeforeEntryRevisionCreateTopicParams>;
-    onAfterEntryRevisionCreate: Topic<AfterEntryRevisionCreateTopicParams>;
+    onBeforeEntryCreateRevision: Topic<BeforeEntryCreateRevisionTopicParams>;
+    onAfterEntryCreateRevision: Topic<AfterEntryCreateRevisionTopicParams>;
     onBeforeEntryUpdate: Topic<BeforeEntryUpdateTopicParams>;
     onAfterEntryUpdate: Topic<AfterEntryUpdateTopicParams>;
     onBeforeEntryDelete: Topic<BeforeEntryDeleteTopicParams>;
     onAfterEntryDelete: Topic<AfterEntryDeleteTopicParams>;
-    onBeforeEntryRevisionDelete: Topic<BeforeEntryRevisionDeleteTopicParams>;
-    onAfterEntryRevisionDelete: Topic<AfterEntryRevisionDeleteTopicParams>;
+    onBeforeEntryDeleteRevision: Topic<BeforeEntryDeleteRevisionTopicParams>;
+    onAfterEntryDeleteRevision: Topic<AfterEntryDeleteRevisionTopicParams>;
     onBeforeEntryPublish: Topic<BeforeEntryPublishTopicParams>;
     onAfterEntryPublish: Topic<AfterEntryPublishTopicParams>;
     onBeforeEntryUnpublish: Topic<BeforeEntryUnpublishTopicParams>;
@@ -1589,15 +1834,22 @@ export declare type CmsEntryResolverFactory<TSource = any, TArgs = any, TContext
  */
 export interface CmsSettingsPermission extends SecurityPermission {
 }
+/**
+ * A base security permission for CMS.
+ *
+ * @category SecurityPermission
+ */
+export interface BaseCmsSecurityPermission extends SecurityPermission {
+    own?: boolean;
+    rwd: string | number;
+}
 /**
  * A security permission for content model.
  *
  * @category SecurityPermission
  * @category CmsModel
  */
-export interface CmsModelPermission extends SecurityPermission {
-    own: boolean;
-    rwd: string;
+export interface CmsModelPermission extends BaseCmsSecurityPermission {
     /**
      * A object representing `key: model.modelId` values where key is locale code.
      */
@@ -1617,9 +1869,7 @@ export interface CmsModelPermission extends SecurityPermission {
  * @category SecurityPermission
  * @category CmsGroup
  */
-export interface CmsGroupPermission extends SecurityPermission {
-    own: boolean;
-    rwd: string;
+export interface CmsGroupPermission extends BaseCmsSecurityPermission {
     /**
      * A object representing `key: group.id` values where key is locale code.
      */
@@ -1633,10 +1883,8 @@ export interface CmsGroupPermission extends SecurityPermission {
  * @category SecurityPermission
  * @category CmsEntry
  */
-export interface CmsEntryPermission extends SecurityPermission {
-    own: boolean;
-    rwd: string;
-    pw: string;
+export interface CmsEntryPermission extends BaseCmsSecurityPermission {
+    pw?: string;
     /**
      * A object representing `key: model.modelId` values where key is locale code.
      */
@@ -1665,13 +1913,10 @@ export interface CmsGroupStorageOperationsListParams {
     sort?: string[];
 }
 export interface CmsGroupStorageOperationsCreateParams {
-    input: CmsGroupCreateInput;
     group: CmsGroup;
 }
 export interface CmsGroupStorageOperationsUpdateParams {
-    original: CmsGroup;
     group: CmsGroup;
-    input: CmsGroupUpdateInput;
 }
 export interface CmsGroupStorageOperationsDeleteParams {
     group: CmsGroup;
@@ -1717,13 +1962,10 @@ export interface CmsModelStorageOperationsListParams {
     where: CmsModelStorageOperationsListWhereParams;
 }
 export interface CmsModelStorageOperationsCreateParams {
-    input: CmsModelCreateInput;
     model: CmsModel;
 }
 export interface CmsModelStorageOperationsUpdateParams {
-    original: CmsModel;
     model: CmsModel;
-    input: CmsModelUpdateInput;
 }
 export interface CmsModelStorageOperationsDeleteParams {
     model: CmsModel;
@@ -1763,14 +2005,12 @@ export interface CmsEntryStorageOperationsGetParams {
 export interface CmsEntryStorageOperationsListParams {
     where: CmsEntryListWhere;
     sort?: CmsEntryListSort;
+    search?: string;
+    fields?: string[];
     limit?: number;
-    after?: string;
+    after?: string | null;
 }
 export interface CmsEntryStorageOperationsCreateParams<T extends CmsStorageEntry = CmsStorageEntry> {
-    /**
-     * Input received from the user.
-     */
-    input: Record<string, any>;
     /**
      * Real entry, with no transformations on it.
      */
@@ -1781,22 +2021,6 @@ export interface CmsEntryStorageOperationsCreateParams<T extends CmsStorageEntry
     storageEntry: T;
 }
 export interface CmsEntryStorageOperationsCreateRevisionFromParams<T extends CmsStorageEntry = CmsStorageEntry> {
-    /**
-     * The entry we are creating new one from.
-     */
-    originalEntry: CmsEntry;
-    /**
-     * The entry we are creating new one from, directly from storage, with transformations on it.
-     */
-    originalStorageEntry: T;
-    /**
-     * Latest entry, used to calculate the new version.
-     */
-    latestEntry: CmsEntry;
-    /**
-     * Latest entry, used to calculate the new version, directly from storage, with transformations.
-     */
-    latestStorageEntry: T;
     /**
      * Real entry, with no transformations on it.
      */
@@ -1807,18 +2031,6 @@ export interface CmsEntryStorageOperationsCreateRevisionFromParams<T extends Cms
     storageEntry: T;
 }
 export interface CmsEntryStorageOperationsUpdateParams<T extends CmsStorageEntry = CmsStorageEntry> {
-    /**
-     * Input received from the user.
-     */
-    input: Record<string, any>;
-    /**
-     * Used to compare IDs, versions and passed into storage operations to be used if required.
-     */
-    originalEntry: CmsEntry;
-    /**
-     * Directly from storage, with transformations on it.
-     */
-    originalStorageEntry: T;
     /**
      * Real entry, with no transformations on it.
      */
@@ -1832,39 +2044,27 @@ export interface CmsEntryStorageOperationsDeleteRevisionParams<T extends CmsStor
     /**
      * Entry that was deleted.
      */
-    entryToDelete: CmsEntry;
+    entry: CmsEntry;
     /**
      * Entry that was deleted, directly from storage, with transformations.
      */
-    storageEntryToDelete: T;
+    storageEntry: T;
     /**
      * Entry that was set as latest.
      */
-    entryToSetAsLatest?: CmsEntry;
+    latestEntry: CmsEntry | null;
     /**
      * Entry that was set as latest, directly from storage, with transformations.
      */
-    storageEntryToSetAsLatest?: T;
+    latestStorageEntry: T | null;
 }
-export interface CmsEntryStorageOperationsDeleteParams<T extends CmsStorageEntry = CmsStorageEntry> {
+export interface CmsEntryStorageOperationsDeleteParams {
     /**
      * Entry that is going to be deleted.
      */
     entry: CmsEntry;
-    /**
-     * Entry that is going to be deleted, directly from storage.
-     */
-    storageEntry: T;
 }
 export interface CmsEntryStorageOperationsPublishParams<T extends CmsStorageEntry = CmsStorageEntry> {
-    /**
-     * The entry record before it was published.
-     */
-    originalEntry: CmsEntry;
-    /**
-     * Directly from storage, with transformations on it.
-     */
-    originalStorageEntry: T;
     /**
      * The modified entry that is going to be saved as published.
      * Entry is in its original form.
@@ -1876,14 +2076,6 @@ export interface CmsEntryStorageOperationsPublishParams<T extends CmsStorageEntr
     storageEntry: T;
 }
 export interface CmsEntryStorageOperationsUnpublishParams<T extends CmsStorageEntry = CmsStorageEntry> {
-    /**
-     * The entry record before it was unpublished.
-     */
-    originalEntry: CmsEntry;
-    /**
-     * The entry record before it was unpublished, with transformations on it.
-     */
-    originalStorageEntry: T;
     /**
      * The modified entry that is going to be saved as unpublished.
      */
@@ -1902,14 +2094,6 @@ export interface CmsEntryStorageOperationsRequestChangesParams<T extends CmsStor
      * Entry that is prepared for the storageOperations, with the transformations.
      */
     storageEntry: T;
-    /**
-     * Original entry from the storage.
-     */
-    originalEntry: CmsEntry;
-    /**
-     * Original entry to be updated, directly from storage, with the transformations.
-     */
-    originalStorageEntry: T;
 }
 export interface CmsEntryStorageOperationsRequestReviewParams<T extends CmsStorageEntry = CmsStorageEntry> {
     /**
@@ -1920,17 +2104,6 @@ export interface CmsEntryStorageOperationsRequestReviewParams<T extends CmsStora
      * Entry that is prepared for the storageOperations, with the transformations.
      */
     storageEntry: T;
-    /**
-     * Original entry from the storage.
-     */
-    originalEntry: CmsEntry;
-    /**
-     * Original entry to be updated, directly from storage, with the transformations.
-     */
-    originalStorageEntry: T;
-}
-export interface CmsEntryStorageOperationsGetAllRevisionsParams {
-    ids: readonly string[];
 }
 export interface CmsEntryStorageOperationsGetByIdsParams {
     ids: readonly string[];
@@ -1988,83 +2161,79 @@ export interface CmsEntryStorageOperations<T extends CmsStorageEntry = CmsStorag
     /**
      * Get all the entries of the ids.
      */
-    getByIds: (model: CmsModel, params: CmsEntryStorageOperationsGetByIdsParams) => Promise<T[]>;
+    getByIds: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsGetByIdsParams) => Promise<T[]>;
     /**
      * Get all the published entries of the ids.
      */
-    getPublishedByIds: (model: CmsModel, params: CmsEntryStorageOperationsGetPublishedByIdsParams) => Promise<T[]>;
+    getPublishedByIds: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsGetPublishedByIdsParams) => Promise<T[]>;
     /**
      * Get all the latest entries of the ids.
      */
-    getLatestByIds: (model: CmsModel, params: CmsEntryStorageOperationsGetLatestByIdsParams) => Promise<T[]>;
+    getLatestByIds: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsGetLatestByIdsParams) => Promise<T[]>;
     /**
      * Get all revisions of the given entry id.
      */
-    getRevisions: (model: CmsModel, params: CmsEntryStorageOperationsGetRevisionsParams) => Promise<T[]>;
-    /**
-     * Get all revisions of all of the given IDs.
-     */
-    getAllRevisionsByIds: (model: CmsModel, params: CmsEntryStorageOperationsGetAllRevisionsParams) => Promise<T[]>;
+    getRevisions: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsGetRevisionsParams) => Promise<T[]>;
     /**
      * Get the entry by the given revision id.
      */
-    getRevisionById: (model: CmsModel, params: CmsEntryStorageOperationsGetRevisionParams) => Promise<T | null>;
+    getRevisionById: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsGetRevisionParams) => Promise<T | null>;
     /**
      * Get the published entry by given entryId.
      */
-    getPublishedRevisionByEntryId: (model: CmsModel, params: CmsEntryStorageOperationsGetPublishedRevisionParams) => Promise<T | null>;
+    getPublishedRevisionByEntryId: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsGetPublishedRevisionParams) => Promise<T | null>;
     /**
      * Get the latest entry by given entryId.
      */
-    getLatestRevisionByEntryId: (model: CmsModel, params: CmsEntryStorageOperationsGetLatestRevisionParams) => Promise<T | null>;
+    getLatestRevisionByEntryId: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsGetLatestRevisionParams) => Promise<T | null>;
     /**
      * Get the revision of the entry before given one.
      */
-    getPreviousRevision: (model: CmsModel, params: CmsEntryStorageOperationsGetPreviousRevisionParams) => Promise<T | null>;
+    getPreviousRevision: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsGetPreviousRevisionParams) => Promise<T | null>;
     /**
      * Gets entry by given params.
      */
-    get: (model: CmsModel, params: CmsEntryStorageOperationsGetParams) => Promise<T | null>;
+    get: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsGetParams) => Promise<T | null>;
     /**
      * List all entries. Filterable via params.
      */
-    list: (model: CmsModel, params: CmsEntryStorageOperationsListParams) => Promise<CmsEntryStorageOperationsListResponse<T>>;
+    list: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsListParams) => Promise<CmsEntryStorageOperationsListResponse<T>>;
     /**
      * Create a new entry.
      */
-    create: (model: CmsModel, params: CmsEntryStorageOperationsCreateParams<T>) => Promise<T>;
+    create: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsCreateParams<T>) => Promise<T>;
     /**
      * Create a new entry from existing one.
      */
-    createRevisionFrom: (model: CmsModel, params: CmsEntryStorageOperationsCreateRevisionFromParams<T>) => Promise<T>;
+    createRevisionFrom: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsCreateRevisionFromParams<T>) => Promise<T>;
     /**
      * Update existing entry.
      */
-    update: (model: CmsModel, params: CmsEntryStorageOperationsUpdateParams<T>) => Promise<T>;
+    update: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsUpdateParams<T>) => Promise<T>;
     /**
      * Delete the entry revision.
      */
-    deleteRevision: (model: CmsModel, params: CmsEntryStorageOperationsDeleteRevisionParams<T>) => Promise<void>;
+    deleteRevision: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsDeleteRevisionParams<T>) => Promise<void>;
     /**
      * Delete the entry.
      */
-    delete: (model: CmsModel, params: CmsEntryStorageOperationsDeleteParams<T>) => Promise<void>;
+    delete: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsDeleteParams) => Promise<void>;
     /**
      * Publish the entry.
      */
-    publish: (model: CmsModel, params: CmsEntryStorageOperationsPublishParams<T>) => Promise<T>;
+    publish: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsPublishParams<T>) => Promise<T>;
     /**
      * Unpublish the entry.
      */
-    unpublish: (model: CmsModel, params: CmsEntryStorageOperationsUnpublishParams<T>) => Promise<T>;
+    unpublish: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsUnpublishParams<T>) => Promise<T>;
     /**
      * Request changes the entry.
      */
-    requestChanges: (model: CmsModel, params: CmsEntryStorageOperationsRequestChangesParams<T>) => Promise<T>;
+    requestChanges: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsRequestChangesParams<T>) => Promise<T>;
     /**
      * Request review the entry.
      */
-    requestReview: (model: CmsModel, params: CmsEntryStorageOperationsRequestReviewParams<T>) => Promise<CmsEntry>;
+    requestReview: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsRequestReviewParams<T>) => Promise<CmsEntry>;
 }
 export declare enum CONTENT_ENTRY_STATUS {
     DRAFT = "draft",
@@ -2081,7 +2250,6 @@ export interface CmsSettingsStorageOperationsCreateParams {
     settings: CmsSettings;
 }
 export interface CmsSettingsStorageOperationsUpdateParams {
-    original: CmsSettings;
     settings: CmsSettings;
 }
 export interface CmsSettingsStorageOperations {
@@ -2114,7 +2282,6 @@ export interface CmsSystemStorageOperationsCreateParams {
 }
 export interface CmsSystemStorageOperationsUpdateParams {
     system: CmsSystem;
-    original: CmsSystem;
 }
 export interface CmsSystemStorageOperations {
     /**
@@ -2136,11 +2303,11 @@ export interface HeadlessCmsStorageOperations {
     groups: CmsGroupStorageOperations;
     models: CmsModelStorageOperations;
     entries: CmsEntryStorageOperations;
-    init?: (cms: HeadlessCms) => Promise<void>;
     /**
-     * Plugins to be attached to the main context.
+     * Either attach something from the storage operations or run something in it.
      */
-    plugins?: Plugin[] | Plugin[][];
+    beforeInit?: (context: CmsContext) => Promise<void>;
+    init?: (context: CmsContext) => Promise<void>;
     /**
      * An upgrade to run if necessary.
      */