Question 1

TypeScript 6 にアップグレードした後、'@payloadcms/next/css' のインポートにおける TS2882 error の修正方法

Accepted Answer

`src/payload-css.d.ts` ファイルを作成し、`declare module '@payloadcms/next/css';` を追加します。これにより、副作用インポートに不足している型宣言が提供されます。Payload は将来のアップデートで公式型を提供する可能性があります。

Question 2

Payload CMS メールアダプターにおける nodemailer の脆弱性 GHSA-vvjj-xcjg-gr5g の解決方法

Accepted Answer

@payloadcms/email-nodemailer を最新バージョンにアップグレードしてください（修正はPR #16664によりバージョン3.xで提供されました）。修正済みのnodemailer要件は>=8.0.5です。即時のアップグレードが不可能な場合は、パッケージマネージャーのオーバーライドを使用して安全なバージョンを強制してください。pnpmの場合は、package.jsonに以下を追加します："pnpm": { "overrides": { "nodemailer@<8.0.5": ">=8.0.5" } }。npmの場合は、"overrides": { "nodemailer": ">=8.0.5" } を使用します。その後、'pnpm install' または 'npm install' を実行して適用します。公式アップデートについてはPayload CMSのリリースを監視してください。

Question 3

Payload CMSで@payloadcms/db-mongodbを使用する際の高重大度のNoSQLインジェクション脆弱性（GHSA-wpg9-53fq-2r8h）を修正する方法は？

Accepted Answer

@payloadcms/db-mongodb (3.84.1) で固定されている Mongoose バージョン 8.15.1 が影響を受けます。公式アップデートがリリースされるまでの回避策として、パッケージマネージャーで Mongoose を >=8.22.1 にオーバーライドしてください。pnpm の場合、package.json に次のように追加します: `"pnpm": { "overrides": { "mongoose@<8.22.1": ">=8.22.1" } }`。その後、`pnpm install` を実行します。このパッチバンプによる破壊的変更は想定されていません。今後、ピンが恒久的に引き上げられるリリースについては、Payload リポジトリを監視してください。

Question 4

Payload MCP の update ツールを登録する際に発生する「convertedFields.partial is not a function」エラーを修正する方法

Accepted Answer

これは、TypeScript の `transpileModule` の出力が `"use strict";` プロローグで始まるため、`@payloadcms/plugin-mcp` で発生します。このプラグインはそれを `new Function('z', 'return ' + output)` で評価するため、関数は Zod オブジェクトではなく文字列 `"use strict"` を返してしまいます。評価の前にプロローグを削除するように `convertCollectionSchemaToZod.ts` を修正してください。

```ts
const output = transpileResult.outputText
  .replace(/^["']use strict["'];?\s*/, '')
  .trim()

const convertedFields = new Function('z', `return ${output}`)(z)
```

また、`ZodRecord` には `.partial()` が存在しないため、`z.record(z.any())` のフォールバックを ZodObject 互換のスキーマに置き換えてください。

```ts
return z.object({}).passthrough()
```

一時的な回避策として、TypeScript を 5.9.3 にダウングレードしてください。

```bash
npm install -D typescript@5.9.3
```

Question 5

TypeScript 6 で Payload MCP エラー "convertedFields.partial is not a function" を修正する方法

Accepted Answer

これは、TypeScript 6 が生成された Zod スキーマをトランスパイルする際に、`@payloadcms/plugin-mcp` 3.84.1 に影響します。TypeScript 6 は先頭に `"use strict";` を追加するため、プラグインの `new Function('z', 'return ' + outputText)(z)` が `ZodObject` ではなくその文字列を返してしまいます。

暫定的な回避策: プロジェクトで使用している 5.x 系に TypeScript をダウングレードしてください。例:

```bash
pnpm add -D typescript@~5.7.3
# または
npm install -D typescript@~5.7.3
```

依存関係を再インストールし、開発サーバーを再起動してください。これで MCP の `initialize` リクエストが成功するはずです。

恒久的なプラグインのパッチ: `packages/plugin-mcp/src/utils/schemaConversion/convertCollectionSchemaToZod.ts` で、トランスパイルされた出力を評価する前にディレクティブプロローグを取り除きます:

```ts
const outputText = transpileResult.outputText.replace(
  /^\s*(?:"use strict"|'use strict')\s*;\s*/,
  '',
)

return new Function('z', 'return ' + outputText)(z)
```

これを `pnpm patch` または `patch-package` で適用し、再ビルド/再起動してください。あるいは、プラグイン側でトランスパイラオプションの strict ディレクティブの出力を無効にすることもできますが、プロローグを取り除く方がより堅牢な修正です。

Payload

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト