4장: 컴포넌트 모델과 WIT

package example:blog@1.0.0;
 
interface types {
    // 레코드 — 이름이 붙은 필드의 집합 (struct)
    record post {
        id: u64,
        title: string,
        content: string,
        author: string,
        published: bool,
        tags: list<string>,
        created-at: u64,
    }
 
    // 배리언트 — 여러 케이스 중 하나 (tagged union / enum)
    variant sort-order {
        newest,
        oldest,
        most-viewed,
        by-title(sort-direction),
    }
 
    // 열거형 — 값 없는 배리언트의 축약
    enum sort-direction {
        ascending,
        descending,
    }
 
    // 옵션 타입 — 값이 있거나 없음
    // option<T>는 내장 타입
    
    // 결과 타입 — 성공 또는 실패
    // result<T, E>는 내장 타입
 
    // 플래그 — 비트 플래그 집합
    flags permissions {
        read,
        write,
        execute,
    }
    
    // 튜플
    type point = tuple<f64, f64>;
}

interface database {
    // 리소스 정의 — 불투명 핸들
    resource connection {
        // 생성자
        constructor(url: string);
        
        // 메서드 (self 참조)
        query: func(sql: string) -> result<list<row>, db-error>;
        
        // 정적 메서드
        pool-size: static func() -> u32;
    }
    
    record row {
        columns: list<column-value>,
    }
    
    variant column-value {
        integer(s64),
        float(f64),
        text(string),
        null,
    }
    
    variant db-error {
        connection-failed(string),
        query-failed(string),
        timeout,
    }
}

package example:blog-service@1.0.0;
 
interface reader {
    use types.{post, sort-order};
    
    get-post: func(id: u64) -> option<post>;
    list-posts: func(
        page: u32,
        per-page: u32,
        order: sort-order,
    ) -> list<post>;
    search: func(query: string) -> list<post>;
}
 
interface writer {
    use types.{post};
    
    record create-post-input {
        title: string,
        content: string,
        tags: list<string>,
    }
    
    create-post: func(input: create-post-input) -> result<post, string>;
    update-post: func(id: u64, input: create-post-input) -> result<post, string>;
    delete-post: func(id: u64) -> result<_, string>;
}

world blog-api {
    // 이 컴포넌트가 사용하는 인터페이스 (호스트 제공)
    import wasi:logging/logging;
    import wasi:keyvalue/store;
    
    // 이 컴포넌트가 제공하는 인터페이스
    export reader;
    export writer;
}

# 개별 컴포넌트 빌드
cargo component build --manifest-path auth/Cargo.toml
componentize-py -w business-logic business_logic.py -o business.wasm
tinygo build -target=wasip2 -o cache.wasm cache/main.go
 
# 컴포넌트 구성
wasm-tools compose \
  auth/target/wasm32-wasip2/release/auth.wasm \
  --definitions business.wasm \
  --definitions cache.wasm \
  -o composed-app.wasm

// cargo-component가 자동 생성하는 바인딩 예시
// 개발자는 아래 trait만 구현하면 됩니다
 
impl Guest for Component {
    fn get_post(id: u64) -> Option<Post> {
        // 비즈니스 로직 구현
        Some(Post {
            id,
            title: "Hello".to_string(),
            content: "World".to_string(),
            author: "Kreath".to_string(),
            published: true,
            tags: vec!["wasm".to_string()],
            created_at: 1234567890,
        })
    }
    
    fn list_posts(page: u32, per_page: u32, order: SortOrder) -> Vec<Post> {
        // 구현
        vec![]
    }
}