feat(api-website-builder-workflows): workflows (#4777)

Author: brunozoric

packages/api-headless-cms-workflows/src/state/index.ts

@@ -2,7 +2,7 @@ import type { Context } from "~/types.js";
 import { getModelIdFromAppName } from "~/utils/appName.js";
 import { getStateValues } from "~/utils/state.js";
 import type { IWorkflowState } from "@webiny/api-workflows";
-import type { ICmsEntryState } from "@webiny/api-headless-cms/types/index.js";
+import type { IEntryState } from "@webiny/api-headless-cms/types/index.js";
 
 interface IParams {
     context: Context;
@@ -11,7 +11,7 @@ interface IParams {
 export const attachStateLifecycleEvents = ({ context }: IParams) => {
     const updateEntry = async (
         state: IWorkflowState,
-        values: ICmsEntryState | undefined
+        values: IEntryState | undefined
     ): Promise<void> => {
         const modelId = getModelIdFromAppName(state.app);
         if (!modelId) {

packages/api-headless-cms-workflows/src/utils/state.ts

@@ -1,7 +1,7 @@
-import type { ICmsEntryState } from "@webiny/api-headless-cms/types/index.js";
+import type { IEntryState } from "@webiny/api-headless-cms/types/index.js";
 import type { IWorkflowStateModel } from "@webiny/api-workflows/context/abstractions/WorkflowState.js";
 
-export const getStateValues = (state: IWorkflowStateModel): ICmsEntryState | undefined => {
+export const getStateValues = (state: IWorkflowStateModel): IEntryState | undefined => {
     const activeStep = state.getActiveStep();
     if (!activeStep) {
         return undefined;

packages/api-headless-cms/src/crud/contentEntry/entryDataFactories/state.ts

@@ -1,14 +1,14 @@
-import type { CmsEntry, ICmsEntryState } from "~/types/index.js";
+import type { CmsEntry, IEntryState } from "~/types/index.js";
 
 interface IInputWithPossibleState {
-    state: Partial<ICmsEntryState> | null;
+    state: Partial<IEntryState> | null;
 }
 interface IParams {
     input: Partial<IInputWithPossibleState>;
     original?: CmsEntry | null;
 }
 
-export const getState = ({ input, original }: IParams): ICmsEntryState | undefined => {
+export const getState = ({ input, original }: IParams): IEntryState | undefined => {
     if (
         !input?.state?.stepId ||
         !input.state.state ||

packages/api-headless-cms/src/graphql/schema/baseSchema.ts

@@ -140,14 +140,17 @@ const createSchema = (plugins: PluginsContainer): IGraphQLSchemaPlugin<CmsContex
             }
 
             type CmsEntryState {
+                workflowId: String
                 stepId: ID
                 stepName: String
                 state: CmsEntryStateType
             }
 
             input ListWhereInputCmsEntryState {
+                workflowId: String
                 stepId: ID
                 state: CmsEntryStateType
+                stepName: String
             }
         `,
         resolvers: {}

packages/api-headless-cms/src/types/types.ts

@@ -467,7 +467,7 @@ export interface ICmsEntryLocation {
     folderId?: string | null;
 }
 
-export interface ICmsEntryState {
+export interface IEntryState {
     state: string;
     workflowId: string;
     stepId: string;
@@ -686,7 +686,7 @@ export interface CmsEntry<T = CmsEntryValues> {
      */
     binOriginalFolderId?: string | null;
 
-    state?: ICmsEntryState;
+    state?: IEntryState;
 }
 
 export interface CmsStorageEntry extends CmsEntry {
@@ -1471,7 +1471,7 @@ export type CreateCmsEntryInput<TValues = CmsEntryValues> = TValues & {
         folderId?: string | null;
     };
 
-    state?: Partial<ICmsEntryState>;
+    state?: Partial<IEntryState>;
 };
 
 export interface CreateCmsEntryOptionsInput {
@@ -1511,7 +1511,7 @@ export interface CreateFromCmsEntryInput {
     firstPublishedBy?: CmsIdentity;
     lastPublishedBy?: CmsIdentity;
 
-    state?: Partial<ICmsEntryState>;
+    state?: Partial<IEntryState>;
 
     [key: string]: any;
 }
@@ -1565,7 +1565,7 @@ export type UpdateCmsEntryInput<TValues = CmsEntryValues> = TValues & {
         folderId?: string | null;
     };
 
-    state?: Partial<ICmsEntryState>;
+    state?: Partial<IEntryState>;
 };
 
 export interface UpdateCmsEntryOptionsInput {

packages/api-website-builder-workflows/.babelrc.js

@@ -0,0 +1,3 @@
+module.exports = require("@webiny/build-tools").createBabelConfigForNode({
+    path: __dirname
+});

packages/api-website-builder-workflows/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Webiny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/api-website-builder-workflows/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@webiny/api-website-builder-workflows",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "index.js",
+  "description": "Headless CMS Workflows",
+  "keywords": [
+    "api-website-builder-workflows:base"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/webiny/webiny-js.git",
+    "directory": "packages/api-website-builder-workflows"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@webiny/api-website-builder": "0.0.0",
+    "@webiny/api-workflows": "0.0.0",
+    "@webiny/error": "0.0.0",
+    "@webiny/handler": "0.0.0",
+    "@webiny/handler-graphql": "0.0.0"
+  },
+  "devDependencies": {
+    "@webiny/build-tools": "0.0.0",
+    "@webiny/plugins": "0.0.0",
+    "@webiny/project-utils": "0.0.0",
+    "@webiny/testing": "0.0.0",
+    "typescript": "5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  }
+}

packages/api-website-builder-workflows/src/constants.ts

@@ -0,0 +1 @@
+export const WB_PAGE_APP = "wb.page";

packages/api-website-builder-workflows/src/graphql/page.ts

@@ -0,0 +1,49 @@
+import { GraphQLSchemaPlugin } from "@webiny/handler-graphql";
+import type { Context } from "~/types.js";
+
+export const createWebsiteBuilderPageGraphQLExtension = () => {
+    return new GraphQLSchemaPlugin<Context>({
+        isApplicable: context => {
+            if (!context.wcp.canUseWorkflows()) {
+                return false;
+            } else if (!context.workflows) {
+                return false;
+            } else if (!context.websiteBuilder) {
+                return false;
+            }
+            return true;
+        },
+        typeDefs: /* GraphQL */ `
+            # CmsEntryStateType
+            enum WbPageStateType {
+                pending
+                inReview
+                rejected
+                approved
+            }
+
+            # CmsEntryState
+            type WbPageState {
+                workflowId: String
+                stepId: ID
+                stepName: String
+                state: WbPageStateType
+            }
+
+            extend type WbPage {
+                state: WbPageState
+            }
+
+            input ListWhereInputWbPageState {
+                workflowId: String
+                stepId: ID
+                state: CmsEntryStateType
+                stepName: String
+            }
+
+            extend input WbPagesListWhereInput {
+                state: ListWhereInputWbPageState
+            }
+        `
+    });
+};