native_runtime_stack.h

Go to the documentation of this file.

/**
 * @file
 * @brief Declares runtime stack helpers for app discovery, reload detection, and request matching.
 */
 
#ifndef PHAROS_NATIVE_RUNTIME_STACK_H
#define PHAROS_NATIVE_RUNTIME_STACK_H
 
#include "native_runtime_types.h"
 
/** @name Runtime stack helpers
 * @{
 */
/**
 * @brief Resolves the apps directory configured for a runtime config file.
 * @param conf_path Runtime config file path.
 * @return Newly allocated apps directory path, or NULL when it cannot be resolved.
 */
char *runtime_apps_dir_native(const char *conf_path);
/**
 * @brief Builds a fingerprint string describing the current runtime apps directory state.
 * @param apps_dir Directory containing discoverable apps.
 * @return Newly allocated fingerprint string, or NULL on failure.
 */
char *runtime_apps_fingerprint_native(const char *apps_dir);
/**
 * @brief Emits a startup banner describing the loaded runtime stack.
 * @param stack Loaded runtime stack.
 * @param config Active serve configuration.
 * @param load_ms Milliseconds spent loading the runtime stack.
 */
void runtime_log_banner_native(const RuntimeStack *stack, const ServeConfig *config, long load_ms);
/**
 * @brief Finds the loaded app runtime that should handle a request path.
 * @param stack Runtime stack to search.
 * @param path Normalized request path.
 * @return Pointer to the matching app runtime within stack, or NULL when no app matches.
 */
AppRuntime *runtime_match_app_native(RuntimeStack *stack, const char *path);
 
 
/** @} */
#endif