myvoicemaker 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,280 @@
+interface RateLimitHeaders {
+    limit: number;
+    remaining: number;
+    reset: number;
+}
+interface ApiResponse<T> {
+    data: T;
+    requestId: string | undefined;
+    rateLimit: RateLimitHeaders | undefined;
+}
+type QueryParams = Record<string, string | number | boolean | undefined>;
+
+interface HttpClientConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeoutMs: number;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(config: HttpClientConfig);
+    get<T>(path: string, query?: QueryParams): Promise<ApiResponse<T>>;
+    post<T>(path: string, body: unknown): Promise<ApiResponse<T>>;
+    postMultipart<T>(path: string, filePath: string, fields: Record<string, string | undefined>): Promise<ApiResponse<T>>;
+    private buildUrl;
+    private authHeaders;
+    private fetchWithTimeout;
+    private parseRateLimit;
+    private parseResponse;
+}
+
+declare abstract class BaseModule {
+    protected readonly http: HttpClient;
+    constructor(http: HttpClient);
+}
+
+type SupportedLanguage = "yo" | "ig" | "ha" | "pcm" | "en" | "auto";
+type JobStatus = "queued" | "processing" | "completed" | "failed";
+type OutputAudioFormat = "mp3" | "wav" | "ogg";
+type OutputVideoFormat = "mp4" | "webm";
+type AccountTier = "free" | "starter" | "growth" | "pro" | "enterprise";
+type UsageModule$1 = "tts" | "asr" | "animate" | "explain";
+interface PaginatedResponse<T> {
+    requestId: string;
+    items: T[];
+    nextCursor: string | null;
+}
+interface PollOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+}
+
+interface TranscribeUrlParams {
+    audio: string;
+    language?: SupportedLanguage;
+    webhookUrl?: string;
+}
+interface TranscribeFileParams {
+    language?: SupportedLanguage;
+    webhookUrl?: string;
+}
+interface ListTranscriptionsParams {
+    limit?: number;
+    cursor?: string;
+    status?: "QUEUED" | "PROCESSING" | "COMPLETED" | "FAILED";
+}
+interface TranscriptionJob {
+    requestId: string;
+    job_id: string;
+    status: JobStatus;
+    language: string;
+    detected_language: string | null;
+    text: string | null;
+    confidence: number | null;
+    duration_seconds: number | null;
+    credits_used: number | null;
+    created_at: string;
+    completed_at: string | null;
+}
+
+declare class ASRModule extends BaseModule {
+    transcribe(params: TranscribeUrlParams): Promise<TranscriptionJob>;
+    transcribeFile(filePath: string, params?: TranscribeFileParams): Promise<TranscriptionJob>;
+    getResult(jobId: string): Promise<TranscriptionJob>;
+    list(params?: ListTranscriptionsParams): Promise<PaginatedResponse<TranscriptionJob>>;
+    poll(jobId: string, options?: PollOptions): Promise<TranscriptionJob>;
+}
+
+interface ListVoicesParams {
+    language?: SupportedLanguage;
+}
+interface Voice {
+    id: string;
+    name: string;
+    gender: "male" | "female";
+    language: string;
+    style: string;
+    sample_url: string;
+}
+interface VoiceListResponse {
+    voices: Voice[];
+}
+interface TtsGenerateParams {
+    text: string;
+    voice_id: string;
+    language: SupportedLanguage;
+    speed?: number;
+    output_format?: OutputAudioFormat;
+}
+interface TtsGenerateResponse {
+    requestId: string;
+    id: string;
+    audio_url: string;
+    duration_seconds: number | null;
+    characters: number;
+    credits_used: number;
+    language: string;
+    voice_id: string;
+    created_at: string;
+}
+
+declare class TTSModule extends BaseModule {
+    listVoices(params?: ListVoicesParams): Promise<VoiceListResponse>;
+    generate(params: TtsGenerateParams): Promise<TtsGenerateResponse>;
+}
+
+interface AnimateGenerateParams {
+    image_url: string;
+    audio_url: string;
+    output_format?: OutputVideoFormat;
+}
+interface AnimateJobResponse {
+    requestId: string;
+    job_id: string;
+    status: "queued";
+    estimated_credits: number;
+    created_at: string;
+}
+interface AnimateResultResponse {
+    requestId: string;
+    job_id: string;
+    status: JobStatus;
+    video_url: string | null;
+    duration_seconds: number | null;
+    credits_used: number | null;
+    created_at: string;
+    completed_at: string | null;
+    error: string | null;
+}
+
+declare class AnimateModule extends BaseModule {
+    generate(params: AnimateGenerateParams): Promise<AnimateJobResponse>;
+    getResult(jobId: string): Promise<AnimateResultResponse>;
+    poll(jobId: string, options?: PollOptions): Promise<AnimateResultResponse>;
+}
+
+type ExplainAction = "explain" | "summarize" | "translate" | "simplify";
+interface ExplainParams {
+    text: string;
+    language: SupportedLanguage;
+    action: ExplainAction;
+    target_language?: SupportedLanguage;
+    max_tokens?: number;
+}
+interface ExplainResponse {
+    id: string;
+    action: ExplainAction;
+    language: string;
+    result: string;
+    tokens_used: number;
+    credits_used: number;
+    created_at: string;
+}
+
+declare class ExplainModule extends BaseModule {
+    process(params: ExplainParams): Promise<ExplainResponse>;
+}
+
+interface UsageBalanceResponse {
+    account_id: string;
+    tier: AccountTier;
+    credits_remaining: number;
+    credits_used: number;
+    credits_total?: number;
+    credits_expire: string | null;
+    created_at: string;
+}
+interface UsageBreakdownParams {
+    start_date: string;
+    end_date: string;
+    module?: UsageModule$1;
+}
+interface UsageBreakdownEntry {
+    module: UsageModule$1;
+    requests: number;
+    credits_used: number;
+}
+interface UsageBreakdownResponse {
+    breakdown: UsageBreakdownEntry[];
+    total_requests: number;
+    total_credits_used: number;
+}
+
+declare class UsageModule extends BaseModule {
+    getBalance(): Promise<UsageBalanceResponse>;
+    getBreakdown(params: UsageBreakdownParams): Promise<UsageBreakdownResponse>;
+}
+
+interface VoiceMakerConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+declare class VoiceMaker {
+    readonly tts: TTSModule;
+    readonly asr: ASRModule;
+    readonly animate: AnimateModule;
+    readonly explain: ExplainModule;
+    readonly usage: UsageModule;
+    constructor(config: VoiceMakerConfig);
+}
+
+interface ApiErrorIssue {
+    field: string;
+    code: string;
+    message: string;
+}
+interface ApiErrorBody {
+    error: string;
+    detail: string;
+    requestId?: string;
+    issues?: ApiErrorIssue[];
+}
+declare class VoiceMakerError extends Error {
+    constructor(message: string);
+}
+declare class VoiceMakerAPIError extends VoiceMakerError {
+    readonly status: number;
+    readonly error: string;
+    readonly detail: string;
+    readonly requestId: string | undefined;
+    readonly issues: ApiErrorIssue[] | undefined;
+    constructor(status: number, body: ApiErrorBody, message?: string);
+}
+declare class AuthenticationError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class InsufficientCreditsError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class PermissionError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class NotFoundError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class FileSizeLimitError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class UnsupportedMediaTypeError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class ValidationError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class RateLimitError extends VoiceMakerAPIError {
+    readonly retryAfter: number | undefined;
+    constructor(body: ApiErrorBody, retryAfter?: number);
+}
+declare class ServerError extends VoiceMakerAPIError {
+    constructor(status: number, body: ApiErrorBody);
+}
+declare class TimeoutError extends VoiceMakerError {
+    readonly jobId: string;
+    readonly timeoutMs: number;
+    constructor(jobId: string, timeoutMs: number);
+}
+
+export { type AccountTier, type AnimateGenerateParams, type AnimateJobResponse, type AnimateResultResponse, type ApiErrorBody, type ApiErrorIssue, AuthenticationError, type ExplainAction, type ExplainParams, type ExplainResponse, FileSizeLimitError, InsufficientCreditsError, type JobStatus, type ListTranscriptionsParams, type ListVoicesParams, NotFoundError, type OutputAudioFormat, type OutputVideoFormat, type PaginatedResponse, PermissionError, type PollOptions, RateLimitError, ServerError, type SupportedLanguage, TimeoutError, type TranscribeFileParams, type TranscribeUrlParams, type TranscriptionJob, type TtsGenerateParams, type TtsGenerateResponse, UnsupportedMediaTypeError, type UsageBalanceResponse, type UsageBreakdownEntry, type UsageBreakdownParams, type UsageBreakdownResponse, type UsageModule$1 as UsageModule, ValidationError, type Voice, type VoiceListResponse, VoiceMaker, VoiceMakerAPIError, type VoiceMakerConfig, VoiceMakerError };

package/dist/index.d.ts

@@ -0,0 +1,280 @@
+interface RateLimitHeaders {
+    limit: number;
+    remaining: number;
+    reset: number;
+}
+interface ApiResponse<T> {
+    data: T;
+    requestId: string | undefined;
+    rateLimit: RateLimitHeaders | undefined;
+}
+type QueryParams = Record<string, string | number | boolean | undefined>;
+
+interface HttpClientConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeoutMs: number;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(config: HttpClientConfig);
+    get<T>(path: string, query?: QueryParams): Promise<ApiResponse<T>>;
+    post<T>(path: string, body: unknown): Promise<ApiResponse<T>>;
+    postMultipart<T>(path: string, filePath: string, fields: Record<string, string | undefined>): Promise<ApiResponse<T>>;
+    private buildUrl;
+    private authHeaders;
+    private fetchWithTimeout;
+    private parseRateLimit;
+    private parseResponse;
+}
+
+declare abstract class BaseModule {
+    protected readonly http: HttpClient;
+    constructor(http: HttpClient);
+}
+
+type SupportedLanguage = "yo" | "ig" | "ha" | "pcm" | "en" | "auto";
+type JobStatus = "queued" | "processing" | "completed" | "failed";
+type OutputAudioFormat = "mp3" | "wav" | "ogg";
+type OutputVideoFormat = "mp4" | "webm";
+type AccountTier = "free" | "starter" | "growth" | "pro" | "enterprise";
+type UsageModule$1 = "tts" | "asr" | "animate" | "explain";
+interface PaginatedResponse<T> {
+    requestId: string;
+    items: T[];
+    nextCursor: string | null;
+}
+interface PollOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+}
+
+interface TranscribeUrlParams {
+    audio: string;
+    language?: SupportedLanguage;
+    webhookUrl?: string;
+}
+interface TranscribeFileParams {
+    language?: SupportedLanguage;
+    webhookUrl?: string;
+}
+interface ListTranscriptionsParams {
+    limit?: number;
+    cursor?: string;
+    status?: "QUEUED" | "PROCESSING" | "COMPLETED" | "FAILED";
+}
+interface TranscriptionJob {
+    requestId: string;
+    job_id: string;
+    status: JobStatus;
+    language: string;
+    detected_language: string | null;
+    text: string | null;
+    confidence: number | null;
+    duration_seconds: number | null;
+    credits_used: number | null;
+    created_at: string;
+    completed_at: string | null;
+}
+
+declare class ASRModule extends BaseModule {
+    transcribe(params: TranscribeUrlParams): Promise<TranscriptionJob>;
+    transcribeFile(filePath: string, params?: TranscribeFileParams): Promise<TranscriptionJob>;
+    getResult(jobId: string): Promise<TranscriptionJob>;
+    list(params?: ListTranscriptionsParams): Promise<PaginatedResponse<TranscriptionJob>>;
+    poll(jobId: string, options?: PollOptions): Promise<TranscriptionJob>;
+}
+
+interface ListVoicesParams {
+    language?: SupportedLanguage;
+}
+interface Voice {
+    id: string;
+    name: string;
+    gender: "male" | "female";
+    language: string;
+    style: string;
+    sample_url: string;
+}
+interface VoiceListResponse {
+    voices: Voice[];
+}
+interface TtsGenerateParams {
+    text: string;
+    voice_id: string;
+    language: SupportedLanguage;
+    speed?: number;
+    output_format?: OutputAudioFormat;
+}
+interface TtsGenerateResponse {
+    requestId: string;
+    id: string;
+    audio_url: string;
+    duration_seconds: number | null;
+    characters: number;
+    credits_used: number;
+    language: string;
+    voice_id: string;
+    created_at: string;
+}
+
+declare class TTSModule extends BaseModule {
+    listVoices(params?: ListVoicesParams): Promise<VoiceListResponse>;
+    generate(params: TtsGenerateParams): Promise<TtsGenerateResponse>;
+}
+
+interface AnimateGenerateParams {
+    image_url: string;
+    audio_url: string;
+    output_format?: OutputVideoFormat;
+}
+interface AnimateJobResponse {
+    requestId: string;
+    job_id: string;
+    status: "queued";
+    estimated_credits: number;
+    created_at: string;
+}
+interface AnimateResultResponse {
+    requestId: string;
+    job_id: string;
+    status: JobStatus;
+    video_url: string | null;
+    duration_seconds: number | null;
+    credits_used: number | null;
+    created_at: string;
+    completed_at: string | null;
+    error: string | null;
+}
+
+declare class AnimateModule extends BaseModule {
+    generate(params: AnimateGenerateParams): Promise<AnimateJobResponse>;
+    getResult(jobId: string): Promise<AnimateResultResponse>;
+    poll(jobId: string, options?: PollOptions): Promise<AnimateResultResponse>;
+}
+
+type ExplainAction = "explain" | "summarize" | "translate" | "simplify";
+interface ExplainParams {
+    text: string;
+    language: SupportedLanguage;
+    action: ExplainAction;
+    target_language?: SupportedLanguage;
+    max_tokens?: number;
+}
+interface ExplainResponse {
+    id: string;
+    action: ExplainAction;
+    language: string;
+    result: string;
+    tokens_used: number;
+    credits_used: number;
+    created_at: string;
+}
+
+declare class ExplainModule extends BaseModule {
+    process(params: ExplainParams): Promise<ExplainResponse>;
+}
+
+interface UsageBalanceResponse {
+    account_id: string;
+    tier: AccountTier;
+    credits_remaining: number;
+    credits_used: number;
+    credits_total?: number;
+    credits_expire: string | null;
+    created_at: string;
+}
+interface UsageBreakdownParams {
+    start_date: string;
+    end_date: string;
+    module?: UsageModule$1;
+}
+interface UsageBreakdownEntry {
+    module: UsageModule$1;
+    requests: number;
+    credits_used: number;
+}
+interface UsageBreakdownResponse {
+    breakdown: UsageBreakdownEntry[];
+    total_requests: number;
+    total_credits_used: number;
+}
+
+declare class UsageModule extends BaseModule {
+    getBalance(): Promise<UsageBalanceResponse>;
+    getBreakdown(params: UsageBreakdownParams): Promise<UsageBreakdownResponse>;
+}
+
+interface VoiceMakerConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+declare class VoiceMaker {
+    readonly tts: TTSModule;
+    readonly asr: ASRModule;
+    readonly animate: AnimateModule;
+    readonly explain: ExplainModule;
+    readonly usage: UsageModule;
+    constructor(config: VoiceMakerConfig);
+}
+
+interface ApiErrorIssue {
+    field: string;
+    code: string;
+    message: string;
+}
+interface ApiErrorBody {
+    error: string;
+    detail: string;
+    requestId?: string;
+    issues?: ApiErrorIssue[];
+}
+declare class VoiceMakerError extends Error {
+    constructor(message: string);
+}
+declare class VoiceMakerAPIError extends VoiceMakerError {
+    readonly status: number;
+    readonly error: string;
+    readonly detail: string;
+    readonly requestId: string | undefined;
+    readonly issues: ApiErrorIssue[] | undefined;
+    constructor(status: number, body: ApiErrorBody, message?: string);
+}
+declare class AuthenticationError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class InsufficientCreditsError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class PermissionError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class NotFoundError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class FileSizeLimitError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class UnsupportedMediaTypeError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class ValidationError extends VoiceMakerAPIError {
+    constructor(body: ApiErrorBody);
+}
+declare class RateLimitError extends VoiceMakerAPIError {
+    readonly retryAfter: number | undefined;
+    constructor(body: ApiErrorBody, retryAfter?: number);
+}
+declare class ServerError extends VoiceMakerAPIError {
+    constructor(status: number, body: ApiErrorBody);
+}
+declare class TimeoutError extends VoiceMakerError {
+    readonly jobId: string;
+    readonly timeoutMs: number;
+    constructor(jobId: string, timeoutMs: number);
+}
+
+export { type AccountTier, type AnimateGenerateParams, type AnimateJobResponse, type AnimateResultResponse, type ApiErrorBody, type ApiErrorIssue, AuthenticationError, type ExplainAction, type ExplainParams, type ExplainResponse, FileSizeLimitError, InsufficientCreditsError, type JobStatus, type ListTranscriptionsParams, type ListVoicesParams, NotFoundError, type OutputAudioFormat, type OutputVideoFormat, type PaginatedResponse, PermissionError, type PollOptions, RateLimitError, ServerError, type SupportedLanguage, TimeoutError, type TranscribeFileParams, type TranscribeUrlParams, type TranscriptionJob, type TtsGenerateParams, type TtsGenerateResponse, UnsupportedMediaTypeError, type UsageBalanceResponse, type UsageBreakdownEntry, type UsageBreakdownParams, type UsageBreakdownResponse, type UsageModule$1 as UsageModule, ValidationError, type Voice, type VoiceListResponse, VoiceMaker, VoiceMakerAPIError, type VoiceMakerConfig, VoiceMakerError };