better-all

ドキュメント

• GitHub リポジトリ：https://github.com/shuding/better-all

注：このライブラリはまだ DeepWiki または Context7 にインデックスされていません。

better-all ライブラリ

better-all は、依存関係を自動的に最適化する Promise.all を提供します。どのタスクを並列実行できるかを手動で分析する代わりに、タスク内で依存関係を宣言するだけで、実行が自動的に最適化されます。

インストール

pnpm add better-all

基本的な使い方

import { all } from "better-all";

const results = await all({
  // Independent tasks run in parallel
  fetchUser: () => fetchUser(userId),
  fetchPosts: () => fetchPosts(userId),

  // Dependent task waits automatically
  combined: async (ctx) => {
    const user = await ctx.$.fetchUser;
    const posts = await ctx.$.fetchPosts;
    return { user, posts };
  },
});

// results.fetchUser, results.fetchPosts, results.combined all typed

主な利点：自動最適化

// Manual approach - error-prone
const [user, posts] = await Promise.all([fetchUser(), fetchPosts()]);
const profile = await buildProfile(user, posts);
const [feed, stats] = await Promise.all([
  buildFeed(profile, posts),
  buildStats(profile),
]);

// better-all - dependencies declared, execution optimized
const results = await all({
  user: () => fetchUser(),
  posts: () => fetchPosts(),
  profile: async (ctx) => buildProfile(await ctx.$.user, await ctx.$.posts),
  feed: async (ctx) => buildFeed(await ctx.$.profile, await ctx.$.posts),
  stats: async (ctx) => buildStats(await ctx.$.profile),
});

型推論

タスクの戻り値の型に基づいて、結果の型がすべて推論されます。

const results = await all({
  count: () => Promise.resolve(42),
  name: () => Promise.resolve("test"),
  combined: async (ctx) => ({
    count: await ctx.$.count,
    name: await ctx.$.name,
  }),
});

// TypeScript knows:
// results.count: number
// results.name: string
// results.combined: { count: number; name: string }

参考資料

• 複雑な DAG パターンについては、dag-patterns.md を参照してください。