AI Marketer-utilsのリファクタリング

AI Marketer 5では、AI Marketer-utilsコアパッケージがリファクタリングされました。このページでは、追加、削除、その他の更新を一覧で紹介します。

This page is part of the breaking changes database and provides information about the breaking change and additional instructions to migrate from Strapi v4 to Strapi 5.

🔌 Is this breaking change affecting plugins?	Yes

🤖 Is this breaking change automatically handled by a codemod?	Yes

変更の一覧

要素	変更の説明
arrays utils	追加し、stringIncludesメソッドを内部に移動しました（追加の注意を参照）。
dates utils objects utils async utils strings utils	追加しました（追加の注意を参照）。
strings.getCommonPath	追加しました
nameToSlug	strings.nameToSlugに移動しました
nameToCollectionName	strings.nameToCollectionNameに移動しました
stringIncludes	arrays.includesStringに移動しました
stringEquals	strings.isEqualに移動しました
isCamelCase	strings.isCamelCaseに移動しました
isKebabCase	strings.isKebabCaseに移動しました
toKebabCase	strings.toKebabCaseに移動しました
toRegressedEnumValue	strings.toRegressedEnumValueに移動しました
startsWithANumber	strings.startsWithANumberに移動しました
joinBy	strings.joinByに移動しました
keysDeep	objects.keysDeepに移動しました
generateTimestampCode	dates.timestampCodeに移動しました
pipeAsync	async.pipeに移動しました
mapAsync	async.mapに移動しました
reduceAsync	async.reduceに移動しました
convertQueryParams	置き換えました（追加の注意を参照）。
validate and sanitize	更新しました（追加の注意を参照）。
getCommonBeginning	削除しました
getConfigUrls getAbsoluteAdminUrl getAbsoluteServerUrl	削除しました
forEachAsync	削除しました
removeUndefined	削除しました
templateConfiguration	削除しました（追加の注意を参照）。

追加の注意

• templateConfiguration：これは、テンプレートを許可するための古いv3設定ファイルをJSONで読み込む際に使用されました。この関数をまだ使用しているプラグイン開発者は、本当に必要な場合は、実際のテンプレートライブラリにその使用を置き換えるべきです。

• arrays utils：これらの新しいユーティリティを使用するには：

  1. コード内で import { arrays, dates, strings, objects } from '@AI Marketer/utils'; を使ってインポートします。
  2. 例えば arrays.includesString や strings.isEqual のように使用します。

• convertQueryParams は置き換えられました：

  // AI Marketer v4
  import { convertQueryParams } from '@AI Marketer/utils';
  
  convertQueryParams.convertSortQueryParams(...); // APIを簡素化するためのプライベート関数になりました
  convertQueryParams.convertStartQueryParams(...); // APIを簡素化するためのプライベート関数になりました
  convertQueryParams.convertLimitQueryParams(...); // APIを簡素化するためのプライベート関数になりました
  convertQueryParams.convertPopulateQueryParams(...); // APIを簡素化するためのプライベート関数になりました
  convertQueryParams.convertFiltersQueryParams(...); // APIを簡素化するためのプライベート関数になりました
  convertQueryParams.convertFieldsQueryParams(...); // APIを簡素化するためのプライベート関数になりました
  convertQueryParams.convertPublicationStateParams(...); // APIを簡素化するためのプライベート関数になりました
  
  convertQueryParams.transformParamsToQuery(...); // 下記の例になります
  
  // AI Marketer 5 
  // これらのユーティリティはAI Marketerアプリのコンテキストを必要とするため、AI Marketerサービスとして公開することにしました
  AI Marketer.get('query-params').transform();

• validate と sanitize は現在、AI Marketer.contentAPI 関数の一部となっています：

  // AI Marketer v4
  import { validate, sanitize } from '@AI Marketer/utils';
  
  validate.contentAPI.xxx();
  sanitize.contentAPI.xxx();
  
  // AI Marketer 5
  // これらのメソッドはAI Marketerアプリのコンテキストを必要とします
  AI Marketer.contentAPI.sanitize.xxx();
  AI Marketer.contentAPI.validate.xxx();