ecadforge_app

/**
 * Loads deploy-time app metadata from the first available backend endpoint.
 */
export class AppMetaLoader {
    static #endpointPaths = ['/api/app-meta', '/api/app-meta.php']

    /**
     * Resolves the current app version from the active server contract.
     * @param {typeof fetch | undefined} fetchImplementation
     * @returns {Promise<string>}
     */
    static async loadVersion(
        fetchImplementation = AppMetaLoader.#defaultFetch()
    ) {
        if (typeof fetchImplementation !== 'function') {
            return ''
        }

        for (const endpointPath of AppMetaLoader.#endpointPaths) {
            const version = await AppMetaLoader.#loadEndpointVersion(
                fetchImplementation,
                endpointPath
            )

            if (version) {
                return version
            }
        }

        return ''
    }

    /**
     * Loads one version payload from one metadata endpoint.
     * @param {typeof fetch} fetchImplementation
     * @param {string} endpointPath
     * @returns {Promise<string>}
     */
    static async #loadEndpointVersion(fetchImplementation, endpointPath) {
        try {
            const response = await fetchImplementation(endpointPath, {
                cache: 'no-store'
            })

            if (!response || !response.ok) {
                return ''
            }

            const payload = await response.json()
            return String(payload?.version || '').trim()
        } catch (_error) {
            return ''
        }
    }

    /**
     * Returns a fetch implementation that keeps the browser receiver intact.
     * @returns {typeof fetch | undefined}
     */
    static #defaultFetch() {
        if (typeof globalThis.fetch !== 'function') {
            return undefined
        }

        return globalThis.fetch.bind(globalThis)
    }
}