package OpenAIAsync::Server::API::v1::Completions;

use v5.36.0;
use Object::Pad;
use IO::Async::SSL; # We're not directly using it but I want to enforce that we pull it in when detecting dependencies, since openai itself is always https
use Future::AsyncAwait;
use IO::Async;

use OpenAIAsync::Types::Results;
use OpenAIAsync::Types::Requests;

our $VERSION = '0.02';

# ABSTRACT: Async server for OpenAI style REST API for various AI systems (LLMs, Images, Video, etc.)

=pod

=head1 NAME

OpenAIAsync::Server::API::Completions - Basic completion api role, consumed to implement the OpenAI chat completion api.  Does not provide an implementation, you are expected to override them in your class

=head1 SYNOPSIS

...

=cut

role OpenAIAsync::Server::API::v1::Completions :strict(params) {
  ADJUST {
    $self->register_url(
        method => 'POST',
        url => qr{^/v1/completions$}, 
        handle => "completion",
        request_class => "OpenAIAsync::Type::Request::Completion",
        result_class => "OpenAIAsync::Type::Result::Completion",
        decoder => 'www-form-urlencoded', # default is json, we need this for this api
    );
  }
 
  async method completion($req, $future_status, $queue, $ctx, $obj, $params);
}