api.proto

syntax = "proto3";

package configservice;

import "config.proto";

option go_package = "github.com/codec404/Konfig/pkg/pb";

// API Service - handles config uploads and management
service ConfigAPIService {
    // Upload a new configuration
    rpc UploadConfig(UploadConfigRequest) returns (UploadConfigResponse);
    
    // Get configuration by ID
    rpc GetConfig(GetConfigRequest) returns (GetConfigResponse);
    
    // List configurations for a service
    rpc ListConfigs(ListConfigsRequest) returns (ListConfigsResponse);
    
    // Delete a configuration
    rpc DeleteConfig(DeleteConfigRequest) returns (DeleteConfigResponse);
    
    // Start a rollout
    rpc StartRollout(StartRolloutRequest) returns (StartRolloutResponse);
    
    // Get rollout status
    rpc GetRolloutStatus(GetRolloutStatusRequest) returns (GetRolloutStatusResponse);
    
    // Rollback to previous version
    rpc Rollback(RollbackRequest) returns (RollbackResponse);

    // Promote a canary/percentage rollout to a higher target percentage
    rpc PromoteRollout(PromoteRolloutRequest) returns (PromoteRolloutResponse);

    // Get audit log entries
    rpc GetAuditLog(GetAuditLogRequest) returns (GetAuditLogResponse);

    // Get system-wide stats
    rpc GetStats(GetStatsRequest) returns (GetStatsResponse);

    // List all services that have configs
    rpc ListServices(ListServicesRequest) returns (ListServicesResponse);

    // List rollouts with optional status filter
    rpc ListRollouts(ListRolloutsRequest) returns (ListRolloutsResponse);

    // List named configs for a service (one entry per config_name)
    rpc ListNamedConfigs(ListNamedConfigsRequest) returns (ListNamedConfigsResponse);
}

// Upload config request — creates a new version of a named config.
// If config_name does not exist yet this creates it at version 1.
// If it already exists a new version is appended (content required, no blanks).
message UploadConfigRequest {
    string service_name = 1;
    string config_name = 7;         // Named config (e.g. "database-config") — required
    string content = 2;             // Config content — required
    string format = 3;              // "json", "yaml", "toml"
    string created_by = 4;          // User/system uploading
    string description = 5;         // Optional description
    bool validate = 6;              // Validate before upload
}

message UploadConfigResponse {
    string config_id = 1;
    int64 version = 2;
    bool success = 3;
    string message = 4;
    repeated string validation_errors = 5;
}

// Get config request
message GetConfigRequest {
    string config_id = 1;
}

message GetConfigResponse {
    ConfigData config = 1;
    bool success = 2;
    string message = 3;
}

// List versions of a named config
message ListConfigsRequest {
    string service_name = 1;
    string config_name = 4;         // Required: which named config to list versions for
    int32 limit = 2;                // Max results
    int32 offset = 3;               // Pagination offset
}

message ListConfigsResponse {
    repeated ConfigMetadata configs = 1;
    int32 total_count = 2;
    bool success = 3;
}

// Delete config request
message DeleteConfigRequest {
    string config_id = 1;
}

message DeleteConfigResponse {
    bool success = 1;
    string message = 2;
}

// Start rollout request
message StartRolloutRequest {
    string config_id = 1;
    RolloutStrategy strategy = 2;
    int32 target_percentage = 3;   // For PERCENTAGE strategy
}

message StartRolloutResponse {
    bool success = 1;
    string message = 2;
    string rollout_id = 3;
}

// Get rollout status request
message GetRolloutStatusRequest {
    string config_id = 1;
}

message GetRolloutStatusResponse {
    RolloutState rollout_state = 1;
    repeated ServiceInstance instances = 2; // Instances affected
    bool success = 3;
}

// Rollback request — rolls a named config back to a specific version
message RollbackRequest {
    string service_name = 1;
    string config_name = 3;         // Which named config to roll back
    int64 target_version = 2;       // Version to rollback to (0 = one before current)
}

message RollbackResponse {
    bool success = 1;
    string message = 2;
    string config_id = 3;
}

// Promote rollout request
message PromoteRolloutRequest {
    string config_id = 1;
    int32 new_target_percentage = 2;  // New target (must be > current target, <= 100)
}

message PromoteRolloutResponse {
    bool success = 1;
    string message = 2;
    RolloutState rollout_state = 3;  // Updated state after promotion
}

// Audit log entry
message AuditEntry {
    int64 id = 1;
    string config_id = 2;
    string action = 3;
    string performed_by = 4;
    string service_name = 5;
    string details = 6;
    int64 created_at = 7;
}

// GetAuditLog - recent audit trail
message GetAuditLogRequest {
    string service_name = 1;  // Optional: filter by service
    int32 limit = 2;          // Default 20
}

message GetAuditLogResponse {
    repeated AuditEntry entries = 1;
    bool success = 2;
}

// GetStats - system-wide counters
message KonfigStats {
    int32 total_configs = 1;
    int32 active_rollouts = 2;
    int32 total_schemas = 3;
    int32 connected_instances = 4;
    int32 total_services = 5;
}

message GetStatsRequest {}

message GetStatsResponse {
    KonfigStats stats = 1;
    bool success = 2;
}

// Service summary entry
message ServiceSummary {
    string service_name = 1;
    int64  latest_version = 2;
    int32  config_count = 3;
    string latest_updated_at = 4;  // RFC3339 timestamp of latest config
    bool   has_active_rollout = 5;
}

message ListServicesRequest {}

message ListServicesResponse {
    repeated ServiceSummary services = 1;
    bool success = 2;
}

// Rollout summary (for listing)
message RolloutSummary {
    string config_id = 1;
    string service_name = 2;
    string strategy = 3;
    int32  target_percentage = 4;
    int32  current_percentage = 5;
    string status = 6;
    string started_at = 7;
    string completed_at = 8;
}

message ListRolloutsRequest {
    string status_filter = 1; // "ACTIVE" = IN_PROGRESS+PENDING, "" = all recent
    int32  limit = 2;
}

message ListRolloutsResponse {
    repeated RolloutSummary rollouts = 1;
    bool success = 2;
}

// List named configs (one per config_name) for a service
message ListNamedConfigsRequest {
    string service_name = 1;
}

message ListNamedConfigsResponse {
    repeated NamedConfigSummary configs = 1;
    bool success = 2;
}