Alan-Jowett / sonde / 25824716717

81%

push

github

feat(azure-handler): implement ProgramIngest HTTP trigger endpoint (#898)

* feat(azure-handler): implement ProgramIngest HTTP trigger endpoint

Implement the ProgramIngest Azure Function endpoint (WEB-0300) that
accepts ELF binaries via JSON POST, verifies them with Prevail, encodes
deterministic CBOR program images, and stores them in Azure Tables for
delivery via DESIRED_STATE messages.

Changes:

**sonde-azure-handler (lib.rs)**
- Add ProgramImageRow struct and HandlerStore::store_program_image()
  trait method with AzureTablesStore implementation (upsert via
  insert_or_replace).
- Add AzureHandler::handle_program_ingest() — parses JSON body with
  base64-encoded ELF, delegates to ProgramLibrary::ingest_elf() for
  Prevail verification and CBOR encoding, normalizes source_filename,
  and stores the resulting program image.
- Add IngestResponse/IngestError types with HTTP status mapping
  (400/413/422/500).
- Add xtract_http_trigger_body() for Azure Functions HTTP trigger
  envelope parsing and ormat_ingest_response() for \Outputs.res\
  response envelope.
- Input validation: base64 integrity, empty check, 1 MB ELF size limit
  (pre-decode and post-decode), \bi_version\ type/range, and
  \erification_profile\ enum.
- Expand ProgramImageEntity with optional metadata fields
  (\source_filename\, \bi_version\, \size_bytes\,
  \erification_profile\, \created_at\) — backward-compatible with
  existing read path.
- 16 new unit tests covering T-WEB-0301 through T-WEB-0308 plus edge
  cases (invalid base64, missing fields, invalid \bi_version\,
  idempotent re-ingest, envelope parsing).

**sonde-azure-handler (main.rs)**
- Add dedicated \/ProgramIngest\ route separate from the catch-all
  connector message route.

**ProgramIngest/function.json**
- Rename HTTP output binding from \\\ to \es\ for correct
  \Outputs.res\ envelope binding.

**Specification updates**
- \gateway-companion-api.md\: Document key 5 (\ssigned_program_image\)
  in DESIRED_S... (continued)

496 of 547 new or added lines in 2 files covered. (90.68%)

34255 of 41198 relevant lines covered (83.15%)

194.79 hits per line