Crate ifc_lite_server 

IFC-Lite Server - High-performance IFC processing server.

This server provides a REST API for parsing IFC files and extracting geometry. It supports:

• Full synchronous parsing with caching
• Streaming Server-Sent Events for progressive rendering
• Quick metadata extraction without geometry processing

Endpoints

• GET /api/v1/health - Health check
• POST /api/v1/parse - Full parse with all geometry (JSON)
• POST /api/v1/parse/stream - Streaming parse (SSE)
• POST /api/v1/parse/metadata - Quick metadata only
• POST /api/v1/parse/parquet - Full parse with Parquet-encoded geometry (~15x smaller)
• POST /api/v1/parse/parquet/optimized - ara3d BOS-optimized format (~50x smaller)
• GET /api/v1/parse/symbolic/:cache_key - 2D symbol stream (IfcAnnotation + IfcGrid) as JSON
• GET /api/v1/cache/:key - Retrieve cached result
• DELETE /api/v1/cache/:key - Invalidate every cache entry for the source file a cache_key names

Modules

admission 🔒

Request admission control: bounded parse concurrency + a byte-weighted memory budget + a coarse RSS circuit breaker.

config 🔒

Server configuration loaded from environment variables.

error 🔒

Error types and handling for the server.

in_flight 🔒

In-memory marker for “a data-model write is running right now for this cache key” (issue #5129).

mem_policy 🔒

Memory-budget policy: the readers and the resolver that decide the admission byte budget at startup.

middleware 🔒

Middleware modules.

panic_strategy 🔒

Self-check for the panic strategy this binary was actually built with.

routes 🔒

API routes for the IFC server.

services 🔒

Service modules for IFC processing and caching.

types 🔒

Type definitions for API requests and responses.

write_timeout 🔒

Connection-level write-idle enforcement.

Structs

AppState

Application state shared across handlers.

Enums

LogDecision 🔒

Startup log level for the memory-admission “gate off” branch in main, derived purely from the re-parsed IFC_MEM_BUDGET_MB env var (#1547).

Constants

BODY_LIMIT_SLACK_MB 🔒

Slack added on top of max_file_size_mb for the raw framework-level body limit — covers multipart boundary/header overhead so the app’s own FileTooLarge check (clean 413) is what rejects an oversized file, not axum’s raw limit (generic 400 MultipartError).

Statics

GLOBAL 🔒

Functions

build_cors_layer 🔒

Build CORS layer based on configuration.

build_router 🔒

Build the application router with all routes and middleware.

main 🔒

memory_admission_log_level 🔒

Pure decision for LogDecision from the resolved IFC_MEM_BUDGET_MB env var: None (unset/unparseable), Some(0) (explicit opt-out), or Some(n) with n > 0 (an explicit positive budget).