faasjs-utils-data

FaasJS Utils And Data

デフォルトのワークフロー

1. ペイロードの形状に合う最小限のヘルパーを使用します。
2. JSON ヘルパーは JSON ペイロードと、テキストヘルパーはテキストストリームと組み合わせます。
3. 外部データの検証には Zod スキーマを使用し、未知の内部値にはヘルパーの型ガードを使用します。
4. YAML を直接解析する場合は parseYaml() を使用します。段階的な FaasJS 設定の検出が必要な場合は loadConfig() を使用します。
5. Node 側のツールでファイルにアクセスする前に、ルート配下のパスを検証します。

次のリファレンスを読みます

• ポータブルなヘルパーと簡単な選択ルール：references/guidelines/utils.md。
• JSON の解析と JSON ストリーム用ヘルパー：references/guidelines/json.md。
• YAML の直接解析：references/guidelines/yaml.md。
• Zod ヘルパー、オブジェクトの絞り込み、スキーマ解析、パスの包含関係：references/guidelines/valid.md。

注意点

• 内部の制御フローチェックを Zod スキーマに置き換えないでください。
• objectToStream は streamToObject と、stringToStream は streamToString と組み合わせます。
• 設定の段階処理とマージ順序が重要な場合は、YAML を直接解析せずに loadConfig() を使用します。

検証

• ヘルパーの動作を変更した場合は、vp test <pattern> で対象を絞った単体テストを実行します。
• ユーティリティファイルを変更した場合は、引き継ぐ前に vp check --fix を実行します。