@webiny/api-headless-cms 0.0.0-unstable.5e7233243f → 0.0.0-unstable.60a863e033

package/types.d.ts

@@ -1,7 +1,6 @@
 import { Plugin } from "@webiny/plugins/types";
 import { I18NContext, I18NLocale } from "@webiny/api-i18n/types";
 import { Context } from "@webiny/api/types";
-import { TenancyContext } from "@webiny/api-tenancy/types";
 import { GraphQLFieldResolver, GraphQLSchemaDefinition, Resolvers } from "@webiny/handler-graphql/types";
 import { SecurityPermission } from "@webiny/api-security/types";
 import { DbContext } from "@webiny/handler-db/types";
@@ -45,7 +44,7 @@ export interface HeadlessCms extends CmsSettingsContext, CmsSystemContext, CmsGr
  *
  * @category Context
  */
-export interface CmsContext extends Context, DbContext, I18NContext, FileManagerContext, TenancyContext {
+export interface CmsContext extends Context, DbContext, I18NContext, FileManagerContext {
     cms: HeadlessCms;
 }
 interface CmsModelFieldPredefinedValuesValue {
@@ -136,7 +135,7 @@ export interface CmsModelField {
      * A type of the field.
      * We are defining our built-in fields, so people know which are available by the default.
      */
-    type: "boolean" | "datetime" | "file" | "long-text" | "number" | "object" | "ref" | "rich-text" | "text" | string;
+    type: "boolean" | "datetime" | "file" | "long-text" | "number" | "object" | "ref" | "rich-text" | "text" | "dynamicZone" | string;
     /**
      * A unique storage ID for storing actual values.
      * Must in form of a-zA-Z0-9@a-zA-Z0-9@a-zA-Z0-9.
@@ -196,6 +195,10 @@ export interface CmsModelField {
      *
      */
     multipleValues?: boolean;
+    /**
+     * Fields can be tagged to give them contextual meaning.
+     */
+    tags?: string[];
     /**
      * Any user defined settings.
      *
@@ -203,18 +206,42 @@ export interface CmsModelField {
      */
     settings?: CmsModelFieldSettings;
 }
+export interface CmsDynamicZoneTemplate {
+    id: string;
+    name: string;
+    gqlTypeName: string;
+    description: string;
+    icon: string;
+    fields: CmsModelField[];
+    layout: string[][];
+    validation: CmsModelFieldValidation[];
+}
+/**
+ * A definition for dynamic-zone field to show possible type of the field in settings.
+ */
+export interface CmsModelDynamicZoneField extends CmsModelField {
+    /**
+     * Settings object for the field. Contains `templates` property.
+     */
+    settings: {
+        templates: CmsDynamicZoneTemplate[];
+    };
+}
 /**
  * Used for our internal functionality.
  */
 export interface CmsModelFieldWithParent extends CmsModelField {
     parent?: CmsModelFieldWithParent | null;
 }
+export interface CmsModelDynamicZoneFieldWithParent extends CmsModelDynamicZoneField {
+    parent?: CmsModelDynamicZoneFieldWithParent | null;
+}
 /**
  * A definition for dateTime field to show possible type of the field in settings.
  */
 export interface CmsModelDateTimeField extends CmsModelField {
     /**
-     * Settings object for the field. Contains type property.
+     * Settings object for the field. Contains `type` property.
      */
     settings: {
         type: "time" | "date" | "dateTimeWithoutTimezone" | "dateTimeWithTimezone";
@@ -335,6 +362,20 @@ export interface LockedField {
     type: string;
     [key: string]: any;
 }
+/**
+ * @category Database model
+ * @category CmsModel
+ */
+export interface CmsModelGroup {
+    /**
+     * Generated ID of the group
+     */
+    id: string;
+    /**
+     * Name of the group
+     */
+    name: string;
+}
 /**
  * Cms Model defining an entry.
  *
@@ -361,16 +402,7 @@ export interface CmsModel {
     /**
      * Cms Group reference object.
      */
-    group: {
-        /**
-         * Generated ID of the group
-         */
-        id: string;
-        /**
-         * Name of the group
-         */
-        name: string;
-    };
+    group: CmsModelGroup;
     /**
      * Description for the content model.
      */
@@ -402,6 +434,10 @@ export interface CmsModel {
      * ```
      */
     layout: string[][];
+    /**
+     * Models can be tagged to give them contextual meaning.
+     */
+    tags?: string[];
     /**
      * List of locked fields. Updated when entry is saved and a field has been used.
      */
@@ -438,25 +474,40 @@ export interface CmsModelFieldDefinition {
     fields: string;
     typeDefs?: string;
 }
-interface CmsModelFieldToGraphQLCreateResolverParams {
+interface CmsModelFieldToGraphQLCreateResolverParams<TField> {
     models: CmsModel[];
     model: CmsModel;
     graphQLType: string;
-    field: CmsModelField;
+    field: TField;
     createFieldResolvers: any;
 }
-export interface CmsModelFieldToGraphQLCreateResolver {
-    (params: CmsModelFieldToGraphQLCreateResolverParams): GraphQLFieldResolver | {
+export interface CmsModelFieldToGraphQLCreateResolver<TField = CmsModelField> {
+    (params: CmsModelFieldToGraphQLCreateResolverParams<TField>): GraphQLFieldResolver | {
         resolver: GraphQLFieldResolver | null;
         typeResolvers: Resolvers<CmsContext>;
     } | false;
 }
+export interface CmsModelFieldToGraphQLPluginValidateChildFieldsValidateParams<TField extends CmsModelField = CmsModelField> {
+    fields: TField[];
+    originalFields: TField[];
+}
+export interface CmsModelFieldToGraphQLPluginValidateChildFieldsValidate {
+    (params: CmsModelFieldToGraphQLPluginValidateChildFieldsValidateParams): void;
+}
+export interface CmsModelFieldToGraphQLPluginValidateChildFieldsParams<TField extends CmsModelField = CmsModelField> {
+    field: TField;
+    originalField?: TField;
+    validate: CmsModelFieldToGraphQLPluginValidateChildFieldsValidate;
+}
+export interface CmsModelFieldToGraphQLPluginValidateChildFields<TField extends CmsModelField = CmsModelField> {
+    (params: CmsModelFieldToGraphQLPluginValidateChildFieldsParams<TField>): void;
+}
 /**
  * @category Plugin
  * @category ModelField
  * @category GraphQL
  */
-export interface CmsModelFieldToGraphQLPlugin extends Plugin {
+export interface CmsModelFieldToGraphQLPlugin<TField extends CmsModelField = CmsModelField> extends Plugin {
     /**
      * A plugin type
      */
@@ -510,7 +561,7 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
      */
     createStorageId?: (params: {
         model: CmsModel;
-        field: CmsModelField;
+        field: TField;
     }) => string | null | undefined;
     /**
      * Read API methods.
@@ -529,7 +580,7 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          */
         createGetFilters?(params: {
             model: CmsModel;
-            field: CmsModelField;
+            field: TField;
         }): string;
         /**
          * Definition for list filtering for GraphQL.
@@ -549,7 +600,8 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          */
         createListFilters?(params: {
             model: CmsModel;
-            field: CmsModelField;
+            field: TField;
+            plugins: CmsFieldTypePlugins;
         }): string;
         /**
          * Definition of the field type for GraphQL - be aware if multiple values is selected.
@@ -568,12 +620,12 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          */
         createTypeField(params: {
             model: CmsModel;
-            field: CmsModelField;
+            field: TField;
             fieldTypePlugins: CmsFieldTypePlugins;
         }): CmsModelFieldDefinition | string | null;
         /**
          * Definition for field resolver.
-         * By default it is simple return of the `instance.values[storageId]` 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: {
@@ -585,7 +637,7 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          * }
          * ```
          */
-        createResolver?: CmsModelFieldToGraphQLCreateResolver;
+        createResolver?: CmsModelFieldToGraphQLCreateResolver<TField>;
         /**
          * Read API schema definitions for the field and resolvers for them.
          *
@@ -628,7 +680,8 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          */
         createListFilters?: (params: {
             model: CmsModel;
-            field: CmsModelField;
+            field: TField;
+            plugins: CmsFieldTypePlugins;
         }) => string;
         /**
          * Manage API schema definitions for the field and resolvers for them. Probably similar to `read.createSchema`.
@@ -667,7 +720,7 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          */
         createTypeField: (params: {
             model: CmsModel;
-            field: CmsModelField;
+            field: TField;
             fieldTypePlugins: CmsFieldTypePlugins;
         }) => CmsModelFieldDefinition | string | null;
         /**
@@ -687,12 +740,12 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          */
         createInputField: (params: {
             model: CmsModel;
-            field: CmsModelField;
+            field: TField;
             fieldTypePlugins: CmsFieldTypePlugins;
         }) => CmsModelFieldDefinition | string | null;
         /**
          * Definition for field resolver.
-         * By default it is simple return of the `instance.values[storageId]` 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: {
@@ -704,8 +757,13 @@ export interface CmsModelFieldToGraphQLPlugin extends Plugin {
          * }
          * ```
          */
-        createResolver?: CmsModelFieldToGraphQLCreateResolver;
+        createResolver?: CmsModelFieldToGraphQLCreateResolver<TField>;
     };
+    /**
+     *
+     * @param field
+     */
+    validateChildFields?: CmsModelFieldToGraphQLPluginValidateChildFields<TField>;
 }
 /**
  * Check for content model locked field.
@@ -744,7 +802,7 @@ export interface CmsFieldTypePlugins {
     [key: string]: CmsModelFieldToGraphQLPlugin;
 }
 /**
- * A interface describing the reference to a user that created some data in the database.
+ * An interface describing the reference to a user that created some data in the database.
  *
  * @category General
  */
@@ -800,11 +858,16 @@ export interface CmsSettingsContext {
      */
     getModelLastChange: () => Promise<Date>;
 }
-export interface BeforeInstallTopicParams {
+export interface OnSystemBeforeInstallTopicParams {
     tenant: string;
     locale: string;
 }
-export interface AfterInstallTopicParams {
+export interface OnSystemAfterInstallTopicParams {
+    tenant: string;
+    locale: string;
+}
+export interface OnSystemInstallErrorTopicParams {
+    error: Error;
     tenant: string;
     locale: string;
 }
@@ -815,13 +878,25 @@ export declare type CmsSystemContext = {
     installSystem: () => Promise<void>;
     upgradeSystem: (version: string) => Promise<boolean>;
     /**
-     * Events
+     * Lifecycle events - deprecated
+     */
+    /**
+     * @deprecated
+     */
+    onBeforeSystemInstall: Topic<OnSystemBeforeInstallTopicParams>;
+    /**
+     * @deprecated
      */
-    onBeforeSystemInstall: Topic<BeforeInstallTopicParams>;
-    onAfterSystemInstall: Topic<AfterInstallTopicParams>;
+    onAfterSystemInstall: Topic<OnSystemAfterInstallTopicParams>;
+    /**
+     * Released in 5.34.0
+     */
+    onSystemBeforeInstall: Topic<OnSystemBeforeInstallTopicParams>;
+    onSystemAfterInstall: Topic<OnSystemAfterInstallTopicParams>;
+    onSystemInstallError: Topic<OnSystemInstallErrorTopicParams>;
 };
 /**
- * A GraphQL params.data parameter received when creating content model group.
+ * A GraphQL `params.data` parameter received when creating content model group.
  *
  * @category CmsGroup
  * @category GraphQL params
@@ -833,7 +908,7 @@ export interface CmsGroupCreateInput {
     icon: string;
 }
 /**
- * A GraphQL params.data parameter received when updating content model group.
+ * A GraphQL `params.data` parameter received when updating content model group.
  *
  * @category CmsGroup
  * @category GraphQL params
@@ -903,7 +978,7 @@ export interface CmsGroup {
     isPrivate?: boolean;
 }
 /**
- * A data.where parameter received when listing content model groups.
+ * A `data.where` parameter received when listing content model groups.
  *
  * @category CmsGroup
  * @category GraphQL params
@@ -919,21 +994,30 @@ export interface CmsGroupListParams {
  * @category CmsGroup
  * @category Topic
  */
-export interface BeforeGroupCreateTopicParams {
+export interface OnGroupBeforeCreateTopicParams {
+    group: CmsGroup;
+}
+/**
+ * @category CmsGroup
+ * @category Topic
+ */
+export interface OnGroupAfterCreateTopicParams {
     group: CmsGroup;
 }
 /**
  * @category CmsGroup
  * @category Topic
  */
-export interface AfterGroupCreateTopicParams {
+export interface OnGroupCreateErrorTopicParams {
+    input: CmsGroupCreateInput;
     group: CmsGroup;
+    error: Error;
 }
 /**
  * @category CmsGroup
  * @category Topic
  */
-export interface BeforeGroupUpdateTopicParams {
+export interface OnGroupBeforeUpdateTopicParams {
     original: CmsGroup;
     group: CmsGroup;
 }
@@ -941,7 +1025,7 @@ export interface BeforeGroupUpdateTopicParams {
  * @category CmsGroup
  * @category Topic
  */
-export interface AfterGroupUpdateTopicParams {
+export interface OnGroupAfterUpdateTopicParams {
     original: CmsGroup;
     group: CmsGroup;
 }
@@ -949,16 +1033,34 @@ export interface AfterGroupUpdateTopicParams {
  * @category CmsGroup
  * @category Topic
  */
-export interface BeforeGroupDeleteTopicParams {
+export interface OnGroupUpdateErrorTopicParams {
+    input: CmsGroupUpdateInput;
+    original: CmsGroup;
+    group: CmsGroup;
+    error: Error;
+}
+/**
+ * @category CmsGroup
+ * @category Topic
+ */
+export interface OnGroupBeforeDeleteTopicParams {
     group: CmsGroup;
 }
 /**
  * @category CmsGroup
  * @category Topic
  */
-export interface AfterGroupDeleteTopicParams {
+export interface OnGroupAfterDeleteTopicParams {
     group: CmsGroup;
 }
+/**
+ * @category CmsGroup
+ * @category Topic
+ */
+export interface OnGroupDeleteErrorTopicParams {
+    group: CmsGroup;
+    error: Error;
+}
 /**
  * Cms Group in context.
  *
@@ -991,14 +1093,44 @@ export interface CmsGroupContext {
      */
     clearGroupsCache: () => void;
     /**
-     * Events.
+     * Lifecycle events - deprecated
+     */
+    /**
+     * @deprecated
      */
-    onBeforeGroupCreate: Topic<BeforeGroupCreateTopicParams>;
-    onAfterGroupCreate: Topic<AfterGroupCreateTopicParams>;
-    onBeforeGroupUpdate: Topic<BeforeGroupUpdateTopicParams>;
-    onAfterGroupUpdate: Topic<AfterGroupUpdateTopicParams>;
-    onBeforeGroupDelete: Topic<BeforeGroupDeleteTopicParams>;
-    onAfterGroupDelete: Topic<AfterGroupDeleteTopicParams>;
+    onBeforeGroupCreate: Topic<OnGroupBeforeCreateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterGroupCreate: Topic<OnGroupAfterCreateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeGroupUpdate: Topic<OnGroupBeforeUpdateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterGroupUpdate: Topic<OnGroupAfterUpdateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeGroupDelete: Topic<OnGroupBeforeDeleteTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterGroupDelete: Topic<OnGroupAfterDeleteTopicParams>;
+    /**
+     * Lifecycle events released in 5.33.0
+     */
+    onGroupBeforeCreate: Topic<OnGroupBeforeCreateTopicParams>;
+    onGroupAfterCreate: Topic<OnGroupAfterCreateTopicParams>;
+    onGroupCreateError: Topic<OnGroupCreateErrorTopicParams>;
+    onGroupBeforeUpdate: Topic<OnGroupBeforeUpdateTopicParams>;
+    onGroupAfterUpdate: Topic<OnGroupAfterUpdateTopicParams>;
+    onGroupUpdateError: Topic<OnGroupUpdateErrorTopicParams>;
+    onGroupBeforeDelete: Topic<OnGroupBeforeDeleteTopicParams>;
+    onGroupAfterDelete: Topic<OnGroupAfterDeleteTopicParams>;
+    onGroupDeleteError: Topic<OnGroupDeleteErrorTopicParams>;
 }
 /**
  * Definition for content model field validator.
@@ -1017,7 +1149,7 @@ export interface CmsModelFieldValidation {
     };
 }
 /**
- * A GraphQL params.data parameter received when creating content model.
+ * A GraphQL `params.data` parameter received when creating content model.
  *
  * @category GraphQL params
  * @category CmsModel
@@ -1034,7 +1166,7 @@ export interface CmsModelCreateInput {
     /**
      * Description of the content model.
      */
-    description?: string;
+    description?: string | null;
     /**
      * Group where to put the content model in.
      */
@@ -1054,6 +1186,10 @@ export interface CmsModelCreateInput {
      * ```
      */
     layout?: string[][];
+    /**
+     * Models can be tagged to give them contextual meaning.
+     */
+    tags?: string[];
     /**
      * The field that is being displayed as entry title.
      * It is picked as first available text field. Or user can select own field.
@@ -1061,7 +1197,7 @@ export interface CmsModelCreateInput {
     titleFieldId?: string;
 }
 /**
- * A GraphQL params.data parameter received when creating content model from existing model.
+ * A GraphQL `params.data` parameter received when creating content model from existing model.
  *
  * @category GraphQL params
  * @category CmsModel
@@ -1102,11 +1238,15 @@ export interface CmsModelFieldInput {
     /**
      * Text to display below the field to help user what to write in the field.
      */
-    helpText?: string;
+    helpText?: string | null;
     /**
      * Text to display in the field.
      */
-    placeholderText?: string;
+    placeholderText?: string | null;
+    /**
+     * Fields can be tagged to give them contextual meaning.
+     */
+    tags?: string[];
     /**
      * Are multiple values allowed?
      */
@@ -1133,7 +1273,7 @@ export interface CmsModelFieldInput {
     settings?: Record<string, any>;
 }
 /**
- * A GraphQL params.data parameter received when updating content model.
+ * A GraphQL `params.data` parameter received when updating content model.
  *
  * @category GraphQL params
  * @category CmsModel
@@ -1150,7 +1290,7 @@ export interface CmsModelUpdateInput {
     /**
      * A new description of the content model.
      */
-    description?: string;
+    description?: string | null;
     /**
      * A list of content model fields to define the entry values.
      */
@@ -1212,10 +1352,10 @@ export interface CmsEntryValues {
  * @category Database model
  * @category CmsEntry
  */
-export interface CmsEntry {
+export interface CmsEntry<T = CmsEntryValues> {
     /**
      * A version of the webiny this entry was created with.
-     * This can be used when upgrading the system so we know which entries to update.
+     * This can be used when upgrading the system, so we know which entries to update.
      */
     webinyVersion: string;
     /**
@@ -1281,14 +1421,14 @@ export interface CmsEntry {
      *
      * @see CmsModelField
      */
-    values: CmsEntryValues;
+    values: T;
     /**
      * 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.
+     * Introduced with Advanced Publishing Workflow. Will always be inserted once 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.
+     * Available only on the Manage API in entry GraphQL type `meta.data` property.
      */
     meta?: {
         [key: string]: any;
@@ -1321,7 +1461,7 @@ export interface CmsModelManager {
      */
     getPublishedByIds: (ids: string[]) => Promise<CmsEntry[]>;
     /**
-     * Get a list of latest entries by the ID list.
+     * Get a list of the latest entries by the ID list.
      */
     getLatestByIds: (ids: string[]) => Promise<CmsEntry[]>;
     /**
@@ -1329,52 +1469,95 @@ export interface CmsModelManager {
      */
     get: (id: string) => Promise<CmsEntry>;
     /**
-     * Create a entry.
+     * Create an entry.
      */
     create: (data: CreateCmsEntryInput) => Promise<CmsEntry>;
     /**
-     * Update a entry.
+     * Update an entry.
      */
     update: (id: string, data: UpdateCmsEntryInput) => Promise<CmsEntry>;
     /**
-     * Delete a entry.
+     * Delete an entry.
      */
     delete: (id: string) => Promise<void>;
 }
-export interface BeforeModelCreateTopicParams {
+/**
+ * Create
+ */
+export interface OnModelBeforeCreateTopicParams {
     input: CmsModelCreateInput;
     model: CmsModel;
 }
-export interface AfterModelCreateTopicParams {
+export interface OnModelAfterCreateTopicParams {
     input: CmsModelCreateInput;
     model: CmsModel;
 }
-export interface BeforeModelCreateFromTopicParams {
+export interface OnModelCreateErrorTopicParams {
+    input: CmsModelCreateInput;
+    model: CmsModel;
+    error: Error;
+}
+/**
+ * Create From / Clone
+ */
+export interface OnModelBeforeCreateFromTopicParams {
     input: CmsModelCreateInput;
     original: CmsModel;
     model: CmsModel;
 }
-export interface AfterModelCreateFromTopicParams {
+export interface OnModelAfterCreateFromTopicParams {
     input: CmsModelCreateInput;
     original: CmsModel;
     model: CmsModel;
 }
-export interface BeforeModelUpdateTopicParams {
+export interface OnModelCreateFromErrorParams {
+    input: CmsModelCreateInput;
+    original: CmsModel;
+    model: CmsModel;
+    error: Error;
+}
+/**
+ * Update
+ */
+export interface OnModelBeforeUpdateTopicParams {
+    input: CmsModelUpdateInput;
+    original: CmsModel;
+    model: CmsModel;
+}
+export interface OnModelAfterUpdateTopicParams {
     input: CmsModelUpdateInput;
     original: CmsModel;
     model: CmsModel;
 }
-export interface AfterModelUpdateTopicParams {
+export interface OnModelUpdateErrorTopicParams {
     input: CmsModelUpdateInput;
     original: CmsModel;
     model: CmsModel;
+    error: Error;
 }
-export interface BeforeModelDeleteTopicParams {
+/**
+ * Delete
+ */
+export interface OnModelBeforeDeleteTopicParams {
+    model: CmsModel;
+}
+export interface OnModelAfterDeleteTopicParams {
     model: CmsModel;
 }
-export interface AfterModelDeleteTopicParams {
+export interface OnModelDeleteErrorTopicParams {
     model: CmsModel;
+    error: Error;
 }
+/**
+ * Initialize
+ */
+export interface OnModelInitializeParams {
+    model: CmsModel;
+    data: Record<string, any>;
+}
+/**
+ *
+ */
 export interface CmsModelUpdateDirectParams {
     model: CmsModel;
     original: CmsModel;
@@ -1416,7 +1599,14 @@ export interface CmsModelContext {
      */
     deleteModel: (modelId: string) => Promise<void>;
     /**
-     * Get a instance of CmsModelManager for given content modelId.
+     * Possibility for users to trigger the model initialization.
+     * They can hook into it and do what ever they want to.
+     *
+     * Primary idea behind this is creating the index, for the code models, in the ES.
+     */
+    initializeModel: (modelId: string, data: Record<string, any>) => Promise<boolean>;
+    /**
+     * Get an instance of CmsModelManager for given content modelId.
      *
      * @see CmsModelManager
      *
@@ -1436,23 +1626,63 @@ export interface CmsModelContext {
      */
     clearModelsCache: () => void;
     /**
-     * Events.
+     * Lifecycle events - deprecated.
+     */
+    /**
+     * @deprecated
+     */
+    onBeforeModelCreate: Topic<OnModelBeforeCreateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterModelCreate: Topic<OnModelAfterCreateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeModelCreateFrom: Topic<OnModelBeforeCreateFromTopicParams>;
+    /**
+     * @deprecated
      */
-    onBeforeModelCreate: Topic<BeforeModelCreateTopicParams>;
-    onAfterModelCreate: Topic<AfterModelCreateTopicParams>;
-    onBeforeModelCreateFrom: Topic<BeforeModelCreateFromTopicParams>;
-    onAfterModelCreateFrom: Topic<AfterModelCreateFromTopicParams>;
-    onBeforeModelUpdate: Topic<BeforeModelUpdateTopicParams>;
-    onAfterModelUpdate: Topic<AfterModelUpdateTopicParams>;
-    onBeforeModelDelete: Topic<BeforeModelDeleteTopicParams>;
-    onAfterModelDelete: Topic<AfterModelDeleteTopicParams>;
+    onAfterModelCreateFrom: Topic<OnModelAfterCreateFromTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeModelUpdate: Topic<OnModelBeforeUpdateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterModelUpdate: Topic<OnModelAfterUpdateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeModelDelete: Topic<OnModelBeforeDeleteTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterModelDelete: Topic<OnModelAfterDeleteTopicParams>;
+    /**
+     * Lifecycle events - released in 5.33.0
+     */
+    onModelBeforeCreate: Topic<OnModelBeforeCreateTopicParams>;
+    onModelAfterCreate: Topic<OnModelAfterCreateTopicParams>;
+    onModelCreateError: Topic<OnModelCreateErrorTopicParams>;
+    onModelBeforeCreateFrom: Topic<OnModelBeforeCreateFromTopicParams>;
+    onModelAfterCreateFrom: Topic<OnModelAfterCreateFromTopicParams>;
+    onModelCreateFromError: Topic<OnModelCreateFromErrorParams>;
+    onModelBeforeUpdate: Topic<OnModelBeforeUpdateTopicParams>;
+    onModelAfterUpdate: Topic<OnModelAfterUpdateTopicParams>;
+    onModelUpdateError: Topic<OnModelUpdateErrorTopicParams>;
+    onModelBeforeDelete: Topic<OnModelBeforeDeleteTopicParams>;
+    onModelAfterDelete: Topic<OnModelAfterDeleteTopicParams>;
+    onModelDeleteError: Topic<OnModelDeleteErrorTopicParams>;
+    onModelInitialize: Topic<OnModelInitializeParams>;
 }
 /**
  * Available statuses for content entry.
  *
  * @category CmsEntry
  */
-export declare type CmsEntryStatus = "published" | "unpublished" | "reviewRequested" | "changesRequested" | "draft";
+export declare type CmsEntryStatus = "published" | "unpublished" | "draft";
 export interface CmsEntryListWhereRef {
     id?: string;
     id_in?: string[];
@@ -1530,7 +1760,12 @@ export interface CmsEntryListWhere {
     /**
      * This is to allow querying by any content model field defined by the user.
      */
-    [key: string]: any | CmsEntryListWhereRef;
+    [key: string]: string | number | boolean | undefined | string[] | number[] | null | CmsEntryListWhere[] | CmsEntryListWhere | CmsEntryListWhereRef;
+    /**
+     * To allow querying via nested queries, we added the AND / OR properties.
+     */
+    AND?: CmsEntryListWhere[];
+    OR?: CmsEntryListWhere[];
 }
 /**
  * Entry listing sort.
@@ -1583,100 +1818,153 @@ export interface CmsEntryMeta {
      */
     totalCount: number;
 }
-export interface BeforeEntryCreateTopicParams {
+/**
+ * Create
+ */
+export interface OnEntryBeforeCreateTopicParams {
     input: CreateCmsEntryInput;
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface AfterEntryCreateTopicParams {
+export interface OnEntryAfterCreateTopicParams {
     input: CreateCmsEntryInput;
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
-export interface BeforeEntryCreateRevisionTopicParams {
+export interface OnEntryCreateErrorTopicParams {
+    error: Error;
+    input: CreateCmsEntryInput;
+    entry: CmsEntry;
+    model: CmsModel;
+}
+/**
+ * Revision Create
+ */
+export interface OnEntryRevisionBeforeCreateTopicParams {
     input: CreateFromCmsEntryInput;
     entry: CmsEntry;
     original: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface AfterEntryCreateRevisionTopicParams {
+export interface OnEntryRevisionAfterCreateTopicParams {
     input: CreateFromCmsEntryInput;
     entry: CmsEntry;
     original: CmsEntry;
     model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
-export interface BeforeEntryUpdateTopicParams {
+export interface OnEntryCreateRevisionErrorTopicParams {
+    error: Error;
+    input: CreateFromCmsEntryInput;
+    original: CmsEntry;
+    entry: CmsEntry;
+    model: CmsModel;
+}
+/**
+ * Update
+ */
+export interface OnEntryBeforeUpdateTopicParams {
     input: UpdateCmsEntryInput;
     original: CmsEntry;
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface AfterEntryUpdateTopicParams {
+export interface OnEntryAfterUpdateTopicParams {
     input: UpdateCmsEntryInput;
     original: CmsEntry;
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
-export interface BeforeEntryPublishTopicParams {
+export interface OnEntryUpdateErrorTopicParams {
+    error: Error;
+    input: CreateFromCmsEntryInput;
+    entry: CmsEntry;
+    model: CmsModel;
+}
+/**
+ * Publish
+ */
+export interface OnEntryBeforePublishTopicParams {
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface AfterEntryPublishTopicParams {
+export interface OnEntryAfterPublishTopicParams {
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
-export interface BeforeEntryUnpublishTopicParams {
+export interface OnEntryPublishErrorTopicParams {
+    error: Error;
+    entry: CmsEntry;
+    model: StorageOperationsCmsModel;
+}
+/**
+ * Republish
+ */
+export interface OnEntryBeforeRepublishTopicParams {
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface AfterEntryUnpublishTopicParams {
+export interface OnEntryAfterRepublishTopicParams {
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
-export interface BeforeEntryRequestChangesTopicParams {
+export interface OnEntryRepublishErrorTopicParams {
+    error: Error;
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface AfterEntryRequestChangesTopicParams {
+/**
+ * Unpublish
+ */
+export interface OnEntryBeforeUnpublishTopicParams {
+    entry: CmsEntry;
+    model: StorageOperationsCmsModel;
+}
+export interface OnEntryAfterUnpublishTopicParams {
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
     storageEntry: CmsEntry;
 }
-export interface BeforeEntryRequestReviewTopicParams {
+export interface OnEntryUnpublishErrorTopicParams {
+    error: Error;
+    entry: CmsEntry;
+    model: CmsModel;
+}
+export interface OnEntryBeforeDeleteTopicParams {
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface AfterEntryRequestReviewTopicParams {
+export interface OnEntryAfterDeleteTopicParams {
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
-    storageEntry: CmsEntry;
 }
-export interface BeforeEntryDeleteTopicParams {
+export interface OnEntryDeleteErrorTopicParams {
+    error: Error;
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface AfterEntryDeleteTopicParams {
+export interface OnEntryRevisionBeforeDeleteTopicParams {
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface BeforeEntryDeleteRevisionTopicParams {
+export interface OnEntryRevisionAfterDeleteTopicParams {
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface AfterEntryDeleteRevisionTopicParams {
+export interface OnEntryRevisionDeleteErrorTopicParams {
+    error: Error;
     entry: CmsEntry;
     model: StorageOperationsCmsModel;
 }
-export interface BeforeEntryGetTopicParams {
+export interface OnEntryBeforeGetTopicParams {
     model: StorageOperationsCmsModel;
     where: CmsEntryListWhere;
 }
-export interface BeforeEntryListTopicParams {
+export interface EntryBeforeListTopicParams {
     where: CmsEntryListWhere;
     model: StorageOperationsCmsModel;
 }
@@ -1685,6 +1973,7 @@ export interface BeforeEntryListTopicParams {
  * @category CmsEntry
  */
 export interface CreateCmsEntryInput {
+    id?: string;
     [key: string]: any;
 }
 /**
@@ -1725,7 +2014,7 @@ export interface CmsEntryContext {
      */
     listEntries: (model: CmsModel, params: CmsEntryListParams) => Promise<[CmsEntry[], CmsEntryMeta]>;
     /**
-     * Lists latest entries. Used for manage API.
+     * Lists the latest entries. Used for manage API.
      */
     listLatestEntries: (model: CmsModel, params?: CmsEntryListParams) => Promise<[CmsEntry[], CmsEntryMeta]>;
     /**
@@ -1774,40 +2063,105 @@ export interface CmsEntryContext {
      */
     unpublishEntry: (model: CmsModel, id: string) => Promise<CmsEntry>;
     /**
-     * Request a review for the entry.
+     * Get all entry revisions.
      */
-    requestEntryReview: (model: CmsModel, id: string) => Promise<CmsEntry>;
+    getEntryRevisions: (model: CmsModel, id: string) => Promise<CmsEntry[]>;
     /**
-     * Request changes for the entry.
+     * Lifecyle events - deprecated.
      */
-    requestEntryChanges: (model: CmsModel, id: string) => Promise<CmsEntry>;
     /**
-     * Get all entry revisions.
+     * @deprecated
      */
-    getEntryRevisions: (model: CmsModel, id: string) => Promise<CmsEntry[]>;
+    onBeforeEntryCreate: Topic<OnEntryBeforeCreateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterEntryCreate: Topic<OnEntryAfterCreateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeEntryCreateRevision: Topic<OnEntryRevisionBeforeCreateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterEntryCreateRevision: Topic<OnEntryRevisionAfterCreateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeEntryUpdate: Topic<OnEntryBeforeUpdateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterEntryUpdate: Topic<OnEntryAfterUpdateTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeEntryDelete: Topic<OnEntryBeforeDeleteTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterEntryDelete: Topic<OnEntryAfterDeleteTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeEntryDeleteRevision: Topic<OnEntryRevisionBeforeDeleteTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterEntryDeleteRevision: Topic<OnEntryRevisionAfterDeleteTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeEntryPublish: Topic<OnEntryBeforePublishTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterEntryPublish: Topic<OnEntryAfterPublishTopicParams>;
     /**
-     * Events.
-     */
-    onBeforeEntryCreate: Topic<BeforeEntryCreateTopicParams>;
-    onAfterEntryCreate: Topic<AfterEntryCreateTopicParams>;
-    onBeforeEntryCreateRevision: Topic<BeforeEntryCreateRevisionTopicParams>;
-    onAfterEntryCreateRevision: Topic<AfterEntryCreateRevisionTopicParams>;
-    onBeforeEntryUpdate: Topic<BeforeEntryUpdateTopicParams>;
-    onAfterEntryUpdate: Topic<AfterEntryUpdateTopicParams>;
-    onBeforeEntryDelete: Topic<BeforeEntryDeleteTopicParams>;
-    onAfterEntryDelete: Topic<AfterEntryDeleteTopicParams>;
-    onBeforeEntryDeleteRevision: Topic<BeforeEntryDeleteRevisionTopicParams>;
-    onAfterEntryDeleteRevision: Topic<AfterEntryDeleteRevisionTopicParams>;
-    onBeforeEntryPublish: Topic<BeforeEntryPublishTopicParams>;
-    onAfterEntryPublish: Topic<AfterEntryPublishTopicParams>;
-    onBeforeEntryUnpublish: Topic<BeforeEntryUnpublishTopicParams>;
-    onAfterEntryUnpublish: Topic<AfterEntryUnpublishTopicParams>;
-    onBeforeEntryRequestChanges: Topic<BeforeEntryRequestChangesTopicParams>;
-    onAfterEntryRequestChanges: Topic<AfterEntryRequestChangesTopicParams>;
-    onBeforeEntryRequestReview: Topic<BeforeEntryRequestReviewTopicParams>;
-    onAfterEntryRequestReview: Topic<AfterEntryRequestReviewTopicParams>;
-    onBeforeEntryGet: Topic<BeforeEntryGetTopicParams>;
-    onBeforeEntryList: Topic<BeforeEntryListTopicParams>;
+     * @deprecated
+     */
+    onBeforeEntryUnpublish: Topic<OnEntryBeforeUnpublishTopicParams>;
+    /**
+     * @deprecated
+     */
+    onAfterEntryUnpublish: Topic<OnEntryAfterUnpublishTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeEntryGet: Topic<OnEntryBeforeGetTopicParams>;
+    /**
+     * @deprecated
+     */
+    onBeforeEntryList: Topic<EntryBeforeListTopicParams>;
+    /**
+     * Lifecycle events released in 5.33.0
+     */
+    onEntryBeforeCreate: Topic<OnEntryBeforeCreateTopicParams>;
+    onEntryAfterCreate: Topic<OnEntryAfterCreateTopicParams>;
+    onEntryCreateError: Topic<OnEntryCreateErrorTopicParams>;
+    onEntryRevisionBeforeCreate: Topic<OnEntryRevisionBeforeCreateTopicParams>;
+    onEntryRevisionAfterCreate: Topic<OnEntryRevisionAfterCreateTopicParams>;
+    onEntryRevisionCreateError: Topic<OnEntryCreateRevisionErrorTopicParams>;
+    onEntryBeforeUpdate: Topic<OnEntryBeforeUpdateTopicParams>;
+    onEntryAfterUpdate: Topic<OnEntryAfterUpdateTopicParams>;
+    onEntryUpdateError: Topic<OnEntryUpdateErrorTopicParams>;
+    onEntryBeforeDelete: Topic<OnEntryBeforeDeleteTopicParams>;
+    onEntryAfterDelete: Topic<OnEntryAfterDeleteTopicParams>;
+    onEntryDeleteError: Topic<OnEntryDeleteErrorTopicParams>;
+    onEntryRevisionBeforeDelete: Topic<OnEntryRevisionBeforeDeleteTopicParams>;
+    onEntryRevisionAfterDelete: Topic<OnEntryRevisionAfterDeleteTopicParams>;
+    onEntryRevisionDeleteError: Topic<OnEntryRevisionDeleteErrorTopicParams>;
+    onEntryBeforePublish: Topic<OnEntryBeforePublishTopicParams>;
+    onEntryAfterPublish: Topic<OnEntryAfterPublishTopicParams>;
+    onEntryPublishError: Topic<OnEntryPublishErrorTopicParams>;
+    onEntryBeforeRepublish: Topic<OnEntryBeforeRepublishTopicParams>;
+    onEntryAfterRepublish: Topic<OnEntryAfterRepublishTopicParams>;
+    onEntryRepublishError: Topic<OnEntryRepublishErrorTopicParams>;
+    onEntryBeforeUnpublish: Topic<OnEntryBeforeUnpublishTopicParams>;
+    onEntryAfterUnpublish: Topic<OnEntryAfterUnpublishTopicParams>;
+    onEntryUnpublishError: Topic<OnEntryUnpublishErrorTopicParams>;
+    onEntryBeforeGet: Topic<OnEntryBeforeGetTopicParams>;
+    onEntryBeforeList: Topic<EntryBeforeListTopicParams>;
 }
 /**
  * Parameters for CmsEntryResolverFactory.
@@ -1851,13 +2205,13 @@ export interface BaseCmsSecurityPermission extends SecurityPermission {
  */
 export interface CmsModelPermission extends BaseCmsSecurityPermission {
     /**
-     * A object representing `key: model.modelId` values where key is locale code.
+     * An object representing `key: model.modelId` values where key is locale code.
      */
     models?: {
         [key: string]: string[];
     };
     /**
-     * A object representing `key: group.id` values where key is locale code.
+     * {locale: groupId[]} map, where key is a locale code.
      */
     groups?: {
         [key: string]: string[];
@@ -1871,7 +2225,7 @@ export interface CmsModelPermission extends BaseCmsSecurityPermission {
  */
 export interface CmsGroupPermission extends BaseCmsSecurityPermission {
     /**
-     * A object representing `key: group.id` values where key is locale code.
+     * {locale: groupId[]} map, where key is a locale code.
      */
     groups?: {
         [key: string]: string[];
@@ -1886,13 +2240,13 @@ export interface CmsGroupPermission extends BaseCmsSecurityPermission {
 export interface CmsEntryPermission extends BaseCmsSecurityPermission {
     pw?: string;
     /**
-     * A object representing `key: model.modelId` values where key is locale code.
+     * An object representing `key: model.modelId` values where key is locale code.
      */
     models?: {
         [key: string]: string[];
     };
     /**
-     * A object representing `key: group.id` values where key is locale code.
+     * {locale: groupId[]} map, where key is a locale code.
      */
     groups?: {
         [key: string]: string[];
@@ -2007,7 +2361,7 @@ export interface CmsEntryStorageOperationsListParams {
     sort?: CmsEntryListSort;
     search?: string;
     fields?: string[];
-    limit?: number;
+    limit: number;
     after?: string | null;
 }
 export interface CmsEntryStorageOperationsCreateParams<T extends CmsStorageEntry = CmsStorageEntry> {
@@ -2085,26 +2439,6 @@ export interface CmsEntryStorageOperationsUnpublishParams<T extends CmsStorageEn
      */
     storageEntry: T;
 }
-export interface CmsEntryStorageOperationsRequestChangesParams<T extends CmsStorageEntry = CmsStorageEntry> {
-    /**
-     * Entry data updated with the required properties.
-     */
-    entry: CmsEntry;
-    /**
-     * Entry that is prepared for the storageOperations, with the transformations.
-     */
-    storageEntry: T;
-}
-export interface CmsEntryStorageOperationsRequestReviewParams<T extends CmsStorageEntry = CmsStorageEntry> {
-    /**
-     * Entry that is prepared for the storageOperations.
-     */
-    entry: CmsEntry;
-    /**
-     * Entry that is prepared for the storageOperations, with the transformations.
-     */
-    storageEntry: T;
-}
 export interface CmsEntryStorageOperationsGetByIdsParams {
     ids: readonly string[];
 }
@@ -2226,21 +2560,11 @@ export interface CmsEntryStorageOperations<T extends CmsStorageEntry = CmsStorag
      * Unpublish the entry.
      */
     unpublish: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsUnpublishParams<T>) => Promise<T>;
-    /**
-     * Request changes the entry.
-     */
-    requestChanges: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsRequestChangesParams<T>) => Promise<T>;
-    /**
-     * Request review the entry.
-     */
-    requestReview: (model: StorageOperationsCmsModel, params: CmsEntryStorageOperationsRequestReviewParams<T>) => Promise<CmsEntry>;
 }
 export declare enum CONTENT_ENTRY_STATUS {
     DRAFT = "draft",
     PUBLISHED = "published",
-    UNPUBLISHED = "unpublished",
-    CHANGES_REQUESTED = "changesRequested",
-    REVIEW_REQUESTED = "reviewRequested"
+    UNPUBLISHED = "unpublished"
 }
 export interface CmsSettingsStorageOperationsGetParams {
     locale: string;
@@ -2297,7 +2621,8 @@ export interface CmsSystemStorageOperations {
      */
     update: (params: CmsSystemStorageOperationsUpdateParams) => Promise<CmsSystem>;
 }
-export interface HeadlessCmsStorageOperations {
+export interface HeadlessCmsStorageOperations<C = CmsContext> {
+    name: string;
     system: CmsSystemStorageOperations;
     settings: CmsSettingsStorageOperations;
     groups: CmsGroupStorageOperations;
@@ -2306,8 +2631,8 @@ export interface HeadlessCmsStorageOperations {
     /**
      * Either attach something from the storage operations or run something in it.
      */
-    beforeInit?: (context: CmsContext) => Promise<void>;
-    init?: (context: CmsContext) => Promise<void>;
+    beforeInit?: (context: C) => Promise<void>;
+    init?: (context: C) => Promise<void>;
     /**
      * An upgrade to run if necessary.
      */