native_dynamic_business_logic.h

Go to the documentation of this file.

/**
 * @file
 * @brief Shared declarative action, workflow, and effect helpers for dynamic-app business-logic scaffolding.
 */
 
#ifndef PHAROS_NATIVE_DYNAMIC_BUSINESS_LOGIC_H
#define PHAROS_NATIVE_DYNAMIC_BUSINESS_LOGIC_H
 
#include "native_runtime_types.h"
#include "native_connection.h"
#include "native_http_request.h"
#include "native_yyjson_helpers.h"
 
/**
 * @brief Executes one declarative dynamic-app action contract against JSON state.
 *
 * The shared runtime uses this helper for framework-owned action contracts that
 * express typed inputs, mutation primitives, workflow bindings, effect hooks,
 * and explanation reporting declaratively in app fixtures.
 *
 * @param connection Connection that receives any error or redirect response.
 * @param app Finalized app runtime metadata.
 * @param request Parsed HTTP request.
 * @param action_id Action identifier from the matched route.
 * @return HTTP status code when the helper handled the action, or 0 when no
 *         matching declarative contract exists for the app/action pair.
 */
int native_dynamic_execute_declarative_action(
  NativeConnection *connection,
  const AppRuntime *app,
  const HttpRequest *request,
  const char *action_id
);
 
/**
 * @brief Loads declarative presentation overrides for one action contract.
 *
 * @param app Finalized app runtime metadata.
 * @param action_id Action identifier to inspect.
 * @param submit_label_out Optional duplicated submit label.
 * @param summary_out Optional duplicated summary text.
 * @return 1 when the action contract was found, otherwise 0.
 */
int native_dynamic_action_presentation_dup(
  const AppRuntime *app,
  const char *action_id,
  char **submit_label_out,
  char **summary_out
);
 
#endif