resource_pack_workflow.php

<?php

declare(strict_types=1);

use imperazim\assets\AssetManifest;
use imperazim\assets\resource\ResourcePackDefinition;
use imperazim\assets\resource\ResourcePackPrepareResult;
use imperazim\assets\resource\ResourcePackValidator;
use imperazim\assets\resource\ResourcePackWorkflow;
use imperazim\assets\resource\ResourcePackWorkflowReport;

/**
 * Example: scan plugin assets and fail early if generated files drift.
 */
function validatePluginAssets(string $assetDirectory): AssetManifest {
    $manifest = AssetManifest::fromDirectory($assetDirectory, 'plugin-assets', '1.0.0');
    $report = $manifest->validateAgainstDirectory($assetDirectory);
    if (!$report->isValid()) {
        throw new RuntimeException('Asset validation failed: ' . implode('; ', $report->getProblems()));
    }

    return $manifest;
}

/**
 * Example: prepare a local Bedrock resource pack into a controlled workspace.
 */
function prepareLobbyPack(string $workspace, string $sourceDirectory): ResourcePackPrepareResult {
    $validation = ResourcePackValidator::validateDirectory($sourceDirectory);
    if (!$validation->isValid()) {
        throw new RuntimeException('Invalid resource pack: ' . implode('; ', $validation->getErrors()));
    }

    $workflow = new ResourcePackWorkflow($workspace, [
        new ResourcePackDefinition(
            id: 'lobby',
            sourceDirectory: $sourceDirectory,
            targetArchiveName: 'lobby-pack.zip',
            enabled: true
        ),
    ]);

    return $workflow->prepare('lobby');
}

/**
 * Example: expose pack status in an operator command without guessing from
 * files on disk.
 *
 * @return list<string>
 */
function describePacks(ResourcePackWorkflow $workflow): array {
    return array_map(
        static fn(ResourcePackWorkflowReport $report): string => $report->getDefinition()->getId() . ': ' . $report->getStatus(),
        $workflow->inspectAll()
    );
}