Function fetchItemManifest

packages/cli/src/registry/remote.ts:108–122

(
  name: string,
  type: ItemType,
  baseUrl: string = DEFAULT_REGISTRY_URL,
)

 * Throws on network failure (callers decide whether to degrade gracefully).
 */
export async function fetchItemManifest(
  name: string,
  type: ItemType,
  baseUrl: string = DEFAULT_REGISTRY_URL,
): Promise<RegistryItem> {
  const dir = ITEM_TYPE_DIRS[type];
  const cacheFile = cachePath(baseUrl, `${dir}__${name}`);
  const cached = readCache<RegistryItem>(cacheFile);
  if (cached) return cached;

  const url = `${baseUrl}/${dir}/${name}/registry-item.json`;
  const item = await fetchJson<RegistryItem>(url);
  writeCache(cacheFile, item);
  return item;
}

/**
 * Download a single file referenced by an item to a local destination.