@abinnovision/payloadcms-mcpx 1.0.0-beta.3

package/dist/write/publish-blockers.mjs

@@ -0,0 +1,72 @@
+import { beforeChangeTraverseFields, beforeValidateTraverseFields } from "payload";
+//#region src/write/publish-blockers.ts
+/**
+* Runs Payload's own field validation over a draft without saving anything.
+*
+* Draft saves skip validation unless `versions.drafts.validate` is set, so an
+* agent building a document incrementally gets no signal until a human presses
+* Publish. This is the same traversal a real save runs, exported from
+* `payload`, called with `skipValidation: false` so it collects into `errors`
+* instead of throwing. The `beforeValidate` pass runs first because some field
+* hooks (Lexical's) prepare state in `context` that their `beforeChange`
+* counterpart depends on.
+*
+* Nothing is written: `data` is a copy, the context is a scratch copy and the
+* locale merge actions are discarded. `overrideAccess` is true because the
+* question is "could this be published", not "may this client write it".
+*
+* Limits: only the locale the doc was read in is checked, and field-level
+* `beforeChange` hooks run again, which is safe only for pure ones.
+*/ const collectPublishBlockers = async (req, target) => {
+	const { collection, doc } = target;
+	const id = doc["id"];
+	const errors = [];
+	const data = {
+		...structuredClone(doc),
+		_status: "published"
+	};
+	const shared = {
+		collection,
+		context: { ...req.context },
+		data,
+		doc,
+		global: null,
+		operation: "update",
+		overrideAccess: true,
+		parentIndexPath: "",
+		parentIsLocalized: false,
+		parentPath: "",
+		parentSchemaPath: "",
+		req,
+		siblingDoc: doc,
+		...id === void 0 ? {} : { id }
+	};
+	try {
+		await beforeValidateTraverseFields({
+			...shared,
+			fields: collection.fields,
+			siblingData: data
+		});
+		await beforeChangeTraverseFields({
+			...shared,
+			docWithLocales: doc,
+			errors,
+			fieldLabelPath: "",
+			fields: collection.fields,
+			mergeLocaleActions: [],
+			siblingData: data,
+			siblingDocWithLocales: doc,
+			skipValidation: false
+		});
+	} catch (error) {
+		req.payload.logger.warn(`[payloadcms-mcpx] Could not validate the ${collection.slug} draft: ${error instanceof Error ? error.message : "unknown error"}`);
+		return [];
+	}
+	return errors.map((error) => ({
+		message: error.message,
+		path: error.path,
+		...typeof error.label === "string" ? { field: error.label } : {}
+	}));
+};
+//#endregion
+export { collectPublishBlockers };

package/dist/write/transaction.mjs

@@ -0,0 +1,19 @@
+import { commitTransaction, initTransaction, killTransaction } from "payload";
+//#region src/write/transaction.ts
+/**
+* Runs `fn` inside one database transaction on `req`, so a read followed by a
+* write cannot interleave with another writer. Adapters without transaction
+* support, or a request that already owns one, run `fn` as is.
+*/ const withTransaction = async (req, fn) => {
+	if (!await initTransaction(req)) return await fn();
+	try {
+		const result = await fn();
+		await commitTransaction(req);
+		return result;
+	} catch (error) {
+		await killTransaction(req);
+		throw error;
+	}
+};
+//#endregion
+export { withTransaction };

package/package.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@abinnovision/payloadcms-mcpx",
+  "version": "1.0.0-beta.3",
+  "description": "Payload CMS plugin exposing a fixed, schema-aware MCP tool surface with draft-only writes and per-API-key capabilities.",
+  "keywords": [
+    "payload",
+    "payloadcms",
+    "plugin",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abinnovision/payloadcms-commons.git",
+    "directory": "packages/mcpx"
+  },
+  "license": "Apache-2.0",
+  "author": {
+    "name": "abi group GmbH",
+    "email": "info@abigroup.io",
+    "url": "https://abigroup.io"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "format:check": "prettier --check 'src/**/*.ts' 'test/**/*.ts' '*.{json{,5},md,y{,a}ml}'",
+    "format:fix": "prettier --write 'src/**/*.ts' 'test/**/*.ts' '*.{json{,5},md,y{,a}ml}'",
+    "lint:check": "eslint 'src/**/*.ts' 'test/**/*.ts'",
+    "lint:fix": "eslint 'src/**/*.ts' 'test/**/*.ts' --fix",
+    "test-integration": "vitest --run --config test/integration/vitest.config.mts",
+    "test-unit": "vitest --run --coverage --config vitest.config.mts",
+    "test-unit:watch": "vitest --config vitest.config.mts",
+    "typecheck": "tsc --noEmit"
+  },
+  "lint-staged": {
+    "{src,test}/**/*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json{,5},md,y{,a}ml}": "prettier --write"
+  },
+  "prettier": "@abinnovision/prettier-config",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "rfc6902": "^5.3.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@abinnovision/eslint-config-base": "^3.4.2",
+    "@abinnovision/prettier-config": "^2.2.0",
+    "@arethetypeswrong/core": "^0.18.5",
+    "@payloadcms/db-sqlite": "3.88.0",
+    "@payloadcms/richtext-lexical": "3.88.0",
+    "@swc/core": "^1.16.1",
+    "@types/node": "^26.2.0",
+    "@types/react": "^19.2.18",
+    "@vitest/coverage-v8": "^4.1.10",
+    "eslint": "^10.7.0",
+    "payload": "3.88.0",
+    "prettier": "^3.9.5",
+    "publint": "^0.3.24",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "tsdown": "^0.22.14",
+    "typescript": "^6.0.3",
+    "unplugin-swc": "^1.5.11",
+    "vitest": "^4.1.10"
+  },
+  "peerDependencies": {
+    "payload": ">=3.88.0 <4"
+  },
+  "publishConfig": {
+    "ghpr": true,
+    "npm": true,
+    "npmAccess": "public"
+  }
+}