Function buildPackage

src/services/packageExportService.ts:51–109

(
	app: App,
	options: BuildPackageOptions,
)

}

export async function buildPackage(
	app: App,
	options: BuildPackageOptions,
): Promise<BuildPackageResult> {
	const { choices, rootChoiceIds, quickAddVersion } = options;
	const excludedIds = new Set(options.excludedChoiceIds ?? []);
	const createdAt = options.createdAt ?? new Date().toISOString();

	const closure = collectChoiceClosure(choices, rootChoiceIds, {
		excludedChoiceIds: excludedIds,
	});
	const includedChoiceIds = new Set(closure.choiceIds);
	const scripts = collectScriptDependencies(closure.catalog, closure.choiceIds);
	const files = collectFileDependencies(closure.catalog, closure.choiceIds);

	const assetDescriptors = collectAssetDescriptors(scripts, files);

	const assets = await encodeAssets(app, assetDescriptors);
	const secretOptionNamesByPath = buildSecretOptionNamesByPath(
		assets.encodedAssets,
	);

	const packageChoices: QuickAddPackageChoice[] = closure.choiceIds.map(
			(choiceId) => {
				const entry = closure.catalog.get(choiceId);
				if (!entry) throw new Error(`Choice '${choiceId}' missing from catalog.`);
				const clonedChoice = deepClone(entry.choice);
				pruneChoiceTree(clonedChoice, includedChoiceIds);
				stripUserScriptSecretRefsFromChoice(clonedChoice, {
					secretOptionNamesByPath,
					stripUnknownStringSettings: true,
				});
				return {
					choice: clonedChoice,
					pathHint: [...entry.path],
					parentChoiceId: entry.parentId,
			};
		},
	);

	const normalizedRootIds = rootChoiceIds.filter((id) =>
		includedChoiceIds.has(id),
	);

	const pkg: QuickAddPackage = {
		schemaVersion: QUICKADD_PACKAGE_SCHEMA_VERSION,
		quickAddVersion,
		createdAt,
		rootChoiceIds: [...normalizedRootIds],
		choices: packageChoices,
		assets: assets.encodedAssets,
	};

	return {
		pkg,
		missingChoiceIds: closure.missingChoiceIds,
		missingAssets: assets.missingAssets,
	};