53 lines
1.8 KiB
TypeScript
53 lines
1.8 KiB
TypeScript
 
|
/**
|
||
|
|
* Port traits (interfaces) to external services. Mirrors `apps/application/src/ports/`.
|
||
|
|
* Concrete implementations live in the infrastructure layer.
|
||
|
|
*/
|
||
|
|
import type { ChatMessage, StreamEvent, ToolDef } from "@zesdex/domain";
|
||
|
|
|
||
|
|
/** Abstraction for an LLM provider chat-completion service. */
|
||
|
|
export interface ProviderService {
|
||
|
|
/**
|
||
|
|
* Send a non-streaming chat completion request.
|
||
|
|
* Returns the assistant's `ChatMessage` and optional `[prompt, completion]` token usage.
|
||
|
|
*/
|
||
|
|
chat(
|
||
|
|
messages: ChatMessage[],
|
||
|
|
tools?: ToolDef[],
|
||
|
|
maxTokens?: number,
|
||
|
|
temperature?: number,
|
||
|
|
): Promise<{ message: ChatMessage; usage: [number, number] | null }>;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Send a streaming request. `onEvent` is called per parsed SSE event and
|
||
|
|
* returns `false` to abort. Returns the fully assembled assistant message
|
||
|
|
* and optional usage once the stream completes.
|
||
|
|
*/
|
||
|
|
chatStream(
|
||
|
|
messages: ChatMessage[],
|
||
|
|
tools: ToolDef[],
|
||
|
|
maxTokens: number,
|
||
|
|
temperature: number,
|
||
|
|
onEvent: (event: StreamEvent) => boolean,
|
||
|
|
signal?: AbortSignal,
|
||
|
|
): Promise<{ message: ChatMessage; usage: [number, number] | null }>;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** Abstraction for password hashing and verification. */
|
||
|
|
export interface PasswordService {
|
||
|
|
hash(password: string): Promise<string>;
|
||
|
|
verify(password: string, hash: string): Promise<boolean>;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** Abstraction for JWT-based token generation and verification. */
|
||
|
|
export interface TokenService {
|
||
|
|
/** Generate an `[access, refresh]` token pair for the given subject. */
|
||
|
|
generateTokens(sub: string): [string, string];
|
||
|
|
verifyAccessToken(token: string): string;
|
||
|
|
verifyRefreshToken(token: string): string;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** High-level authentication service combining password + token issuance. */
|
||
|
|
export interface AuthService {
|
||
|
|
authenticate(password: string, hash: string): Promise<boolean>;
|
||
|
|
issueTokens(sub: string): [string, string];
|
||
|
|
}
|