scrabble-game/pkg/proto/botlink/v1/botlink_grpc.pb.go

// Code generated by protoc-gen-go-grpc. DO NOT EDIT.
// versions:
// - protoc-gen-go-grpc v1.5.1
// - protoc             (unknown)
// source: botlink/v1/botlink.proto

// Package scrabble.botlink.v1 is the reverse control channel between a remote
// Telegram bot and the gateway. The bot dials the gateway and opens a single
// long-lived Link stream (mTLS); once the stream is open the gateway pushes send
// Commands down it and the bot returns one Ack per command. This keeps the bot
// egress (the Bot API token, getUpdates long-poll and sendMessage) off the main
// host with no inbound port on the bot. See docs/ARCHITECTURE.md.

package botlinkv1

import (
	context "context"
	grpc "google.golang.org/grpc"
	codes "google.golang.org/grpc/codes"
	status "google.golang.org/grpc/status"
)

// This is a compile-time assertion to ensure that this generated file
// is compatible with the grpc package it is being compiled against.
// Requires gRPC-Go v1.64.0 or later.
const _ = grpc.SupportPackageIsVersion9

const (
	BotLink_Link_FullMethodName                   = "/scrabble.botlink.v1.BotLink/Link"
	BotLink_ResolveChatEligibility_FullMethodName = "/scrabble.botlink.v1.BotLink/ResolveChatEligibility"
	BotLink_ValidatePreCheckout_FullMethodName    = "/scrabble.botlink.v1.BotLink/ValidatePreCheckout"
	BotLink_ForwardPayment_FullMethodName         = "/scrabble.botlink.v1.BotLink/ForwardPayment"
)

// BotLinkClient is the client API for BotLink service.
//
// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.
//
// BotLink is the reverse (bot-dials-gateway) control channel. The bot is the gRPC
// client; once the stream is open the gateway (server) sends Commands at will and
// the bot returns one Ack per command. Delivery is best-effort, at-most-once: a
// command lost across a reconnect is not replayed.
type BotLinkClient interface {
	// Link opens the single bot <-> gateway stream. The first client message is
	// Hello; thereafter the client sends one Ack per received Command.
	Link(ctx context.Context, opts ...grpc.CallOption) (grpc.BidiStreamingClient[FromBot, ToBot], error)
	// ResolveChatEligibility answers whether the Telegram user identified by
	// external_id may write in the moderated discussion chat: registered with an
	// account and neither admin-suspended nor chat-muted. The bot calls it over the
	// same mTLS channel when a user joins the chat, to decide whether to grant the
	// write permission. Delivery of the answer is request/response (not best-effort).
	ResolveChatEligibility(ctx context.Context, in *ChatEligibilityRequest, opts ...grpc.CallOption) (*ChatEligibilityResponse, error)
	// ValidatePreCheckout answers whether a Telegram Stars pre_checkout_query may be
	// approved before any star is charged: the order in the invoice payload exists, is
	// still creditable (pending or an honoured-expired order, never one already paid),
	// and its amount and currency match the invoice. The bot calls it on every
	// pre_checkout_query and approves only on ok; a not-ok answer or a channel failure
	// declines the charge (fail-closed). Reusable Stars invoice links make this gate the
	// one place a repeat payment is stopped before money moves. Request/response.
	ValidatePreCheckout(ctx context.Context, in *PreCheckoutRequest, opts ...grpc.CallOption) (*PreCheckoutResponse, error)
	// ForwardPayment delivers a completed Telegram Stars payment from the bot's durable
	// outbox to the gateway for crediting. The bot calls it (retrying until it gets a
	// response) after Telegram confirms the payment; the gateway forwards it to the
	// backend intake, which credits the order once, idempotent on
	// telegram_payment_charge_id. A response means the payment was durably handled
	// (credited, or recorded as unmatched) and the bot may forget the outbox row; a
	// transport error leaves the row for a later retry. Request/response.
	ForwardPayment(ctx context.Context, in *ForwardPaymentRequest, opts ...grpc.CallOption) (*ForwardPaymentResponse, error)
}

type botLinkClient struct {
	cc grpc.ClientConnInterface
}

func NewBotLinkClient(cc grpc.ClientConnInterface) BotLinkClient {
	return &botLinkClient{cc}
}

func (c *botLinkClient) Link(ctx context.Context, opts ...grpc.CallOption) (grpc.BidiStreamingClient[FromBot, ToBot], error) {
	cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
	stream, err := c.cc.NewStream(ctx, &BotLink_ServiceDesc.Streams[0], BotLink_Link_FullMethodName, cOpts...)
	if err != nil {
		return nil, err
	}
	x := &grpc.GenericClientStream[FromBot, ToBot]{ClientStream: stream}
	return x, nil
}

// This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.
type BotLink_LinkClient = grpc.BidiStreamingClient[FromBot, ToBot]

func (c *botLinkClient) ResolveChatEligibility(ctx context.Context, in *ChatEligibilityRequest, opts ...grpc.CallOption) (*ChatEligibilityResponse, error) {
	cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
	out := new(ChatEligibilityResponse)
	err := c.cc.Invoke(ctx, BotLink_ResolveChatEligibility_FullMethodName, in, out, cOpts...)
	if err != nil {
		return nil, err
	}
	return out, nil
}

func (c *botLinkClient) ValidatePreCheckout(ctx context.Context, in *PreCheckoutRequest, opts ...grpc.CallOption) (*PreCheckoutResponse, error) {
	cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
	out := new(PreCheckoutResponse)
	err := c.cc.Invoke(ctx, BotLink_ValidatePreCheckout_FullMethodName, in, out, cOpts...)
	if err != nil {
		return nil, err
	}
	return out, nil
}

func (c *botLinkClient) ForwardPayment(ctx context.Context, in *ForwardPaymentRequest, opts ...grpc.CallOption) (*ForwardPaymentResponse, error) {
	cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
	out := new(ForwardPaymentResponse)
	err := c.cc.Invoke(ctx, BotLink_ForwardPayment_FullMethodName, in, out, cOpts...)
	if err != nil {
		return nil, err
	}
	return out, nil
}

// BotLinkServer is the server API for BotLink service.
// All implementations must embed UnimplementedBotLinkServer
// for forward compatibility.
//
// BotLink is the reverse (bot-dials-gateway) control channel. The bot is the gRPC
// client; once the stream is open the gateway (server) sends Commands at will and
// the bot returns one Ack per command. Delivery is best-effort, at-most-once: a
// command lost across a reconnect is not replayed.
type BotLinkServer interface {
	// Link opens the single bot <-> gateway stream. The first client message is
	// Hello; thereafter the client sends one Ack per received Command.
	Link(grpc.BidiStreamingServer[FromBot, ToBot]) error
	// ResolveChatEligibility answers whether the Telegram user identified by
	// external_id may write in the moderated discussion chat: registered with an
	// account and neither admin-suspended nor chat-muted. The bot calls it over the
	// same mTLS channel when a user joins the chat, to decide whether to grant the
	// write permission. Delivery of the answer is request/response (not best-effort).
	ResolveChatEligibility(context.Context, *ChatEligibilityRequest) (*ChatEligibilityResponse, error)
	// ValidatePreCheckout answers whether a Telegram Stars pre_checkout_query may be
	// approved before any star is charged: the order in the invoice payload exists, is
	// still creditable (pending or an honoured-expired order, never one already paid),
	// and its amount and currency match the invoice. The bot calls it on every
	// pre_checkout_query and approves only on ok; a not-ok answer or a channel failure
	// declines the charge (fail-closed). Reusable Stars invoice links make this gate the
	// one place a repeat payment is stopped before money moves. Request/response.
	ValidatePreCheckout(context.Context, *PreCheckoutRequest) (*PreCheckoutResponse, error)
	// ForwardPayment delivers a completed Telegram Stars payment from the bot's durable
	// outbox to the gateway for crediting. The bot calls it (retrying until it gets a
	// response) after Telegram confirms the payment; the gateway forwards it to the
	// backend intake, which credits the order once, idempotent on
	// telegram_payment_charge_id. A response means the payment was durably handled
	// (credited, or recorded as unmatched) and the bot may forget the outbox row; a
	// transport error leaves the row for a later retry. Request/response.
	ForwardPayment(context.Context, *ForwardPaymentRequest) (*ForwardPaymentResponse, error)
	mustEmbedUnimplementedBotLinkServer()
}

// UnimplementedBotLinkServer must be embedded to have
// forward compatible implementations.
//
// NOTE: this should be embedded by value instead of pointer to avoid a nil
// pointer dereference when methods are called.
type UnimplementedBotLinkServer struct{}

func (UnimplementedBotLinkServer) Link(grpc.BidiStreamingServer[FromBot, ToBot]) error {
	return status.Errorf(codes.Unimplemented, "method Link not implemented")
}
func (UnimplementedBotLinkServer) ResolveChatEligibility(context.Context, *ChatEligibilityRequest) (*ChatEligibilityResponse, error) {
	return nil, status.Errorf(codes.Unimplemented, "method ResolveChatEligibility not implemented")
}
func (UnimplementedBotLinkServer) ValidatePreCheckout(context.Context, *PreCheckoutRequest) (*PreCheckoutResponse, error) {
	return nil, status.Errorf(codes.Unimplemented, "method ValidatePreCheckout not implemented")
}
func (UnimplementedBotLinkServer) ForwardPayment(context.Context, *ForwardPaymentRequest) (*ForwardPaymentResponse, error) {
	return nil, status.Errorf(codes.Unimplemented, "method ForwardPayment not implemented")
}
func (UnimplementedBotLinkServer) mustEmbedUnimplementedBotLinkServer() {}
func (UnimplementedBotLinkServer) testEmbeddedByValue()                 {}

// UnsafeBotLinkServer may be embedded to opt out of forward compatibility for this service.
// Use of this interface is not recommended, as added methods to BotLinkServer will
// result in compilation errors.
type UnsafeBotLinkServer interface {
	mustEmbedUnimplementedBotLinkServer()
}

func RegisterBotLinkServer(s grpc.ServiceRegistrar, srv BotLinkServer) {
	// If the following call pancis, it indicates UnimplementedBotLinkServer was
	// embedded by pointer and is nil.  This will cause panics if an
	// unimplemented method is ever invoked, so we test this at initialization
	// time to prevent it from happening at runtime later due to I/O.
	if t, ok := srv.(interface{ testEmbeddedByValue() }); ok {
		t.testEmbeddedByValue()
	}
	s.RegisterService(&BotLink_ServiceDesc, srv)
}

func _BotLink_Link_Handler(srv interface{}, stream grpc.ServerStream) error {
	return srv.(BotLinkServer).Link(&grpc.GenericServerStream[FromBot, ToBot]{ServerStream: stream})
}

// This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.
type BotLink_LinkServer = grpc.BidiStreamingServer[FromBot, ToBot]

func _BotLink_ResolveChatEligibility_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
	in := new(ChatEligibilityRequest)
	if err := dec(in); err != nil {
		return nil, err
	}
	if interceptor == nil {
		return srv.(BotLinkServer).ResolveChatEligibility(ctx, in)
	}
	info := &grpc.UnaryServerInfo{
		Server:     srv,
		FullMethod: BotLink_ResolveChatEligibility_FullMethodName,
	}
	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
		return srv.(BotLinkServer).ResolveChatEligibility(ctx, req.(*ChatEligibilityRequest))
	}
	return interceptor(ctx, in, info, handler)
}

func _BotLink_ValidatePreCheckout_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
	in := new(PreCheckoutRequest)
	if err := dec(in); err != nil {
		return nil, err
	}
	if interceptor == nil {
		return srv.(BotLinkServer).ValidatePreCheckout(ctx, in)
	}
	info := &grpc.UnaryServerInfo{
		Server:     srv,
		FullMethod: BotLink_ValidatePreCheckout_FullMethodName,
	}
	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
		return srv.(BotLinkServer).ValidatePreCheckout(ctx, req.(*PreCheckoutRequest))
	}
	return interceptor(ctx, in, info, handler)
}

func _BotLink_ForwardPayment_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
	in := new(ForwardPaymentRequest)
	if err := dec(in); err != nil {
		return nil, err
	}
	if interceptor == nil {
		return srv.(BotLinkServer).ForwardPayment(ctx, in)
	}
	info := &grpc.UnaryServerInfo{
		Server:     srv,
		FullMethod: BotLink_ForwardPayment_FullMethodName,
	}
	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
		return srv.(BotLinkServer).ForwardPayment(ctx, req.(*ForwardPaymentRequest))
	}
	return interceptor(ctx, in, info, handler)
}

// BotLink_ServiceDesc is the grpc.ServiceDesc for BotLink service.
// It's only intended for direct use with grpc.RegisterService,
// and not to be introspected or modified (even as a copy)
var BotLink_ServiceDesc = grpc.ServiceDesc{
	ServiceName: "scrabble.botlink.v1.BotLink",
	HandlerType: (*BotLinkServer)(nil),
	Methods: []grpc.MethodDesc{
		{
			MethodName: "ResolveChatEligibility",
			Handler:    _BotLink_ResolveChatEligibility_Handler,
		},
		{
			MethodName: "ValidatePreCheckout",
			Handler:    _BotLink_ValidatePreCheckout_Handler,
		},
		{
			MethodName: "ForwardPayment",
			Handler:    _BotLink_ForwardPayment_Handler,
		},
	},
	Streams: []grpc.StreamDesc{
		{
			StreamName:    "Link",
			Handler:       _BotLink_Link_Handler,
			ServerStreams: true,
			ClientStreams: true,
		},
	},
	Metadata: "botlink/v1/botlink.proto",
}