alt/services/api/internal/socket/market_test.go

package socket

import (
	"context"
	"testing"
	"time"

	altv1 "git.toki-labs.com/toki/alt/packages/contracts/gen/go/alt/v1"
	"git.toki-labs.com/toki/alt/services/api/internal/workerclient"
	protoSocket "git.toki-labs.com/toki/proto-socket/go"
)

func validBarsRequest() *altv1.ListBarsRequest {
	return &altv1.ListBarsRequest{
		InstrumentId: "KRX:005930",
		Timeframe:    altv1.Timeframe_TIMEFRAME_DAILY,
		FromUnixMs:   time.Date(2026, 5, 1, 0, 0, 0, 0, time.UTC).UnixMilli(),
		ToUnixMs:     time.Date(2026, 5, 15, 0, 0, 0, 0, time.UTC).UnixMilli(),
	}
}

func TestHandleListInstrumentsForwards(t *testing.T) {
	fake := &fakeWorkerClient{instRes: &altv1.ListInstrumentsResponse{
		Instruments: []*altv1.Instrument{{Id: "KRX:005930", Symbol: "005930"}},
	}}
	withWorker(t, fake)

	resp, err := handleListInstruments(&altv1.ListInstrumentsRequest{
		Market:   altv1.Market_MARKET_KR,
		Provider: "kis",
	})
	if err != nil {
		t.Fatalf("unexpected error: %v", err)
	}
	if fake.instReq == nil {
		t.Fatal("expected request to be forwarded to worker")
	}
	if fake.instReq.GetMarket() != altv1.Market_MARKET_KR || fake.instReq.GetProvider() != "kis" {
		t.Errorf("request was not forwarded unchanged: %+v", fake.instReq)
	}
	if len(resp.GetInstruments()) != 1 {
		t.Errorf("expected 1 instrument, got %d", len(resp.GetInstruments()))
	}
}

func TestHandleListInstrumentsRejectsUnknownMarket(t *testing.T) {
	fake := &fakeWorkerClient{}
	withWorker(t, fake)

	resp, err := handleListInstruments(&altv1.ListInstrumentsRequest{Market: altv1.Market(99)})
	if err != nil {
		t.Fatalf("expected typed validation response, got error: %v", err)
	}
	requireMarketError(t, resp.GetError(), marketErrorInvalidRequest)
	if fake.instReq != nil {
		t.Error("worker must not be called when validation fails")
	}
}

func TestHandleListInstrumentsMapsWorkerErrors(t *testing.T) {
	tests := []struct {
		name string
		err  error
		code string
	}{
		{"unavailable", workerclient.ErrUnavailable, marketErrorUnavailable},
		{"timeout", workerclient.ErrTimeout, marketErrorTimeout},
		{"unexpected", context.Canceled, marketErrorInternal},
	}

	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			fake := &fakeWorkerClient{err: tt.err}
			withWorker(t, fake)

			resp, err := handleListInstruments(&altv1.ListInstrumentsRequest{})
			if err != nil {
				t.Fatalf("expected typed worker error response, got error: %v", err)
			}
			requireMarketError(t, resp.GetError(), tt.code)
			if fake.instReq == nil {
				t.Error("valid request should be forwarded before worker error is mapped")
			}
		})
	}
}

func TestHandleListInstrumentsNilWorkerResponse(t *testing.T) {
	fake := &fakeWorkerClient{}
	withWorker(t, fake)

	resp, err := handleListInstruments(&altv1.ListInstrumentsRequest{})
	if err != nil {
		t.Fatalf("expected typed internal response, got error: %v", err)
	}
	requireMarketError(t, resp.GetError(), marketErrorInternal)
	if fake.instReq == nil {
		t.Error("expected request to be forwarded before nil response was detected")
	}
}

func TestHandleListBarsForwards(t *testing.T) {
	fake := &fakeWorkerClient{barsRes: &altv1.ListBarsResponse{
		Bars: []*altv1.Bar{{InstrumentId: "KRX:005930", Timeframe: altv1.Timeframe_TIMEFRAME_DAILY}},
	}}
	withWorker(t, fake)

	resp, err := handleListBars(validBarsRequest())
	if err != nil {
		t.Fatalf("unexpected error: %v", err)
	}
	if fake.barsReq == nil {
		t.Fatal("expected request to be forwarded to worker")
	}
	if fake.barsReq.GetInstrumentId() != "KRX:005930" {
		t.Errorf("instrument id was not forwarded unchanged: %q", fake.barsReq.GetInstrumentId())
	}
	if len(resp.GetBars()) != 1 {
		t.Errorf("expected 1 bar, got %d", len(resp.GetBars()))
	}
}

func TestHandleListBarsValidation(t *testing.T) {
	valid := validBarsRequest()
	tests := []struct {
		name string
		req  *altv1.ListBarsRequest
	}{
		{"missing instrument", &altv1.ListBarsRequest{Timeframe: valid.GetTimeframe(), FromUnixMs: valid.GetFromUnixMs(), ToUnixMs: valid.GetToUnixMs()}},
		{"unknown timeframe", &altv1.ListBarsRequest{InstrumentId: valid.GetInstrumentId(), Timeframe: altv1.Timeframe(99), FromUnixMs: valid.GetFromUnixMs(), ToUnixMs: valid.GetToUnixMs()}},
		{"missing from", &altv1.ListBarsRequest{InstrumentId: valid.GetInstrumentId(), Timeframe: valid.GetTimeframe(), ToUnixMs: valid.GetToUnixMs()}},
		{"missing to", &altv1.ListBarsRequest{InstrumentId: valid.GetInstrumentId(), Timeframe: valid.GetTimeframe(), FromUnixMs: valid.GetFromUnixMs()}},
		{"inverted range", &altv1.ListBarsRequest{InstrumentId: valid.GetInstrumentId(), Timeframe: valid.GetTimeframe(), FromUnixMs: valid.GetToUnixMs(), ToUnixMs: valid.GetFromUnixMs()}},
	}

	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			fake := &fakeWorkerClient{}
			withWorker(t, fake)

			resp, err := handleListBars(tt.req)
			if err != nil {
				t.Fatalf("expected typed validation response, got error: %v", err)
			}
			requireMarketError(t, resp.GetError(), marketErrorInvalidRequest)
			if fake.barsReq != nil {
				t.Error("worker must not be called when validation fails")
			}
		})
	}
}

func TestHandleListBarsNilWorker(t *testing.T) {
	withWorker(t, nil)

	resp, err := handleListBars(validBarsRequest())
	if err != nil {
		t.Fatalf("expected typed unavailable response, got error: %v", err)
	}
	requireMarketError(t, resp.GetError(), marketErrorUnavailable)
}

func TestMarketSocketValidationReturnsTypedErrors(t *testing.T) {
	fake := &fakeWorkerClient{}
	client := startBacktestAPITestClient(t, fake)

	resp, err := protoSocket.SendRequestTyped[*altv1.ListBarsRequest, *altv1.ListBarsResponse](
		&client.Communicator,
		&altv1.ListBarsRequest{},
		500*time.Millisecond,
	)
	if err != nil {
		t.Fatalf("request should return typed error response without timeout: %v", err)
	}
	requireMarketError(t, resp.GetError(), marketErrorInvalidRequest)
	if fake.barsReq != nil {
		t.Fatal("worker must not be called for socket-level validation failures")
	}
}

func TestMarketSocketListInstrumentsForwards(t *testing.T) {
	fake := &fakeWorkerClient{instRes: &altv1.ListInstrumentsResponse{
		Instruments: []*altv1.Instrument{{Id: "KRX:005930", Symbol: "005930"}},
	}}
	client := startBacktestAPITestClient(t, fake)

	resp, err := protoSocket.SendRequestTyped[*altv1.ListInstrumentsRequest, *altv1.ListInstrumentsResponse](
		&client.Communicator,
		&altv1.ListInstrumentsRequest{Market: altv1.Market_MARKET_KR, Provider: "kis"},
		500*time.Millisecond,
	)
	if err != nil {
		t.Fatalf("request should return market response without timeout: %v", err)
	}
	if resp.GetError() != nil {
		t.Fatalf("unexpected market error: %+v", resp.GetError())
	}
	if len(resp.GetInstruments()) != 1 {
		t.Fatalf("expected one instrument, got %d", len(resp.GetInstruments()))
	}
	if fake.instReq == nil || fake.instReq.GetProvider() != "kis" {
		t.Fatalf("expected request to be forwarded to worker, got %+v", fake.instReq)
	}
}

func TestMarketHandlersRegisteredInSession(t *testing.T) {
	registered := make(map[string]bool)
	for _, h := range sessionHandlers() {
		registered[h.requestType] = true
	}
	required := []string{
		protoSocket.TypeNameOf(&altv1.ListInstrumentsRequest{}),
		protoSocket.TypeNameOf(&altv1.ListBarsRequest{}),
	}
	for _, req := range required {
		if !registered[req] {
			t.Errorf("missing API handler registration for %q", req)
		}
	}
}

func requireMarketError(t *testing.T, errInfo *altv1.ErrorInfo, code string) {
	t.Helper()
	if errInfo == nil {
		t.Fatalf("expected ErrorInfo code %q, got nil", code)
	}
	if errInfo.GetCode() != code {
		t.Fatalf("expected ErrorInfo code %q, got %q (%s)", code, errInfo.GetCode(), errInfo.GetMessage())
	}
	if errInfo.GetMessage() == "" {
		t.Fatalf("expected ErrorInfo message for code %q", code)
	}
}