hua-sdk-lite/dist/index.js

HUA Lite API SDK - Emotional AI Chatbot Integration

"use strict";
// 🌟 HUA SDK Lite v2.0.0 - 메인 SDK 클래스
// 리듬이의 마음처럼 사용자를 배려하는 따뜻한 SDK 💖
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    var desc = Object.getOwnPropertyDescriptor(m, k);
    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
      desc = { enumerable: true, get: function() { return m[k]; } };
    }
    Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    o[k2] = m[k];
}));
var __exportStar = (this && this.__exportStar) || function(m, exports) {
    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.formatErrorMessage = exports.isRetryableError = exports.isHUAError = exports.createErrorFromResponse = exports.RetryLimitExceededError = exports.ConfigurationError = exports.OpenAIApiError = exports.InvalidLanguageError = exports.InvalidTierError = exports.InvalidModeError = exports.InvalidToneError = exports.MissingMessageError = exports.InsufficientCreditsError = exports.RateLimitExceededError = exports.GuestKeyLimitExceededError = exports.InvalidApiKeyError = exports.AuthenticationError = exports.ServerError = exports.TimeoutError = exports.NetworkError = exports.ValidationError = exports.MissingApiKeyError = exports.HUAError = exports.HUALite = void 0;
const client_1 = require("./client");
const types_1 = require("./types");
// ===== 프리셋 정보 =====
const PRESET_INFO = {
    gentle: {
        name: '부드러운',
        description: '따뜻하고 위로가 되는 부드러운 톤',
        examples: ['힘들 때 위로받고 싶어요', '마음이 아파요', '조용히 들어주세요']
    },
    warm: {
        name: '따뜻한',
        description: '친근하고 따뜻한 느낌의 톤',
        examples: ['친구처럼 대화하고 싶어요', '편안하게 이야기해요', '따뜻한 조언이 필요해요']
    },
    cheerful: {
        name: '밝은',
        description: '활기차고 긍정적인 톤',
        examples: ['기분을 좋게 해주세요', '힘내고 싶어요', '긍정적인 마음이 필요해요']
    },
    quirky: {
        name: '독특한',
        description: '재미있고 독특한 톤',
        examples: ['재미있게 대화하고 싶어요', '창의적인 답변이 필요해요', '특별한 관점을 원해요']
    },
    delicate: {
        name: '섬세한',
        description: '정중하고 섬세한 톤',
        examples: ['정중하게 대화하고 싶어요', '예의 바른 답변이 필요해요', '공식적인 톤을 원해요']
    }
};
const MODE_INFO = {
    empathy: {
        name: '공감',
        description: '사용자의 감정에 공감하며 위로하는 모드',
        useCases: ['위로가 필요할 때', '감정을 나누고 싶을 때', '공감받고 싶을 때']
    },
    analysis: {
        name: '분석',
        description: '상황을 분석하고 객관적인 관점을 제공하는 모드',
        useCases: ['문제를 분석하고 싶을 때', '객관적인 조언이 필요할 때', '상황을 정리하고 싶을 때']
    },
    suggestion: {
        name: '제안',
        description: '구체적인 해결책이나 제안을 제공하는 모드',
        useCases: ['해결책이 필요할 때', '방향을 제시받고 싶을 때', '실행 가능한 조언을 원할 때']
    },
    praise: {
        name: '칭찬',
        description: '긍정적인 부분을 찾아 칭찬하고 격려하는 모드',
        useCases: ['자신감이 필요할 때', '성취를 축하받고 싶을 때', '긍정적인 에너지가 필요할 때']
    },
    playful: {
        name: '장난스러운',
        description: '재미있고 가벼운 대화를 나누는 모드',
        useCases: ['기분 전환이 필요할 때', '재미있는 대화를 원할 때', '스트레스를 풀고 싶을 때']
    }
};
const TIER_INFO = {
    '1.0': {
        name: '기본',
        description: '간단하고 핵심적인 응답',
        creditCost: 1,
        maxTokens: 300
    },
    '2.0': {
        name: '고급',
        description: '상세하고 풍부한 응답',
        creditCost: 2,
        maxTokens: 500
    },
    '3.0': {
        name: '프리미엄',
        description: '매우 상세하고 정서서적인 응답',
        creditCost: 3,
        maxTokens: 800
    }
};
// ===== 메인 SDK 클래스 =====
class HUALite {
    constructor(apiKey, config = {}) {
        this.client = new client_1.HUALiteClient(apiKey, config);
    }
    // ===== 메인 API 메서드 =====
    async chat(request) {
        return this.client.chat(request);
    }
    async issueKey() {
        return this.client.issueKey();
    }
    // ===== 편의 메서드 =====
    async gentleChat(message, options = {}) {
        return this.chat({
            message,
            tone: 'gentle',
            mode: 'empathy',
            ...options
        });
    }
    async warmChat(message, options = {}) {
        return this.chat({
            message,
            tone: 'warm',
            mode: 'empathy',
            ...options
        });
    }
    async cheerfulChat(message, options = {}) {
        return this.chat({
            message,
            tone: 'cheerful',
            mode: 'praise',
            ...options
        });
    }
    async analyzeChat(message, options = {}) {
        return this.chat({
            message,
            tone: 'delicate',
            mode: 'analysis',
            ...options
        });
    }
    async suggestChat(message, options = {}) {
        return this.chat({
            message,
            tone: 'warm',
            mode: 'suggestion',
            ...options
        });
    }
    // ===== 정보 조회 메서드 =====
    getPresetInfo() {
        return PRESET_INFO;
    }
    getModeInfo() {
        return MODE_INFO;
    }
    getTierInfo() {
        return TIER_INFO;
    }
    getAvailableTones() {
        return [...types_1.TONE_PRESETS];
    }
    getAvailableModes() {
        return [...types_1.MODE_PRESETS];
    }
    getAvailableTiers() {
        return [...types_1.TIER_PRESETS];
    }
    getSupportedLanguages() {
        return [...types_1.SUPPORTED_LANGS];
    }
    getAvailableProviders() {
        return [...types_1.LLM_PROVIDERS];
    }
    // ===== 유틸리티 메서드 =====
    getApiKey() {
        return this.client.getApiKey();
    }
    getConfig() {
        return this.client.getConfig();
    }
    updateConfig(newConfig) {
        this.client.updateConfig(newConfig);
    }
    // ===== 이벤트 시스템 =====
    on(event, listener) {
        this.client.on(event, listener);
    }
    off(event, listener) {
        this.client.off(event, listener);
    }
    // ===== 검증 메서드 =====
    validateTone(tone) {
        return types_1.TONE_PRESETS.includes(tone);
    }
    validateMode(mode) {
        return types_1.MODE_PRESETS.includes(mode);
    }
    validateTier(tier) {
        return types_1.TIER_PRESETS.includes(tier);
    }
    validateLanguage(lang) {
        return types_1.SUPPORTED_LANGS.includes(lang);
    }
    validateProvider(provider) {
        return types_1.LLM_PROVIDERS.includes(provider);
    }
    // ===== 배치 처리 =====
    async batchChat(requests) {
        const promises = requests.map(request => this.chat(request));
        return Promise.all(promises);
    }
    // ===== 스트림 처리 (향후 확장) =====
    async *streamChat(request) {
        // 현재는 일반 응답을 스트림으로 변환
        const response = await this.chat(request);
        yield response.data.message;
    }
}
exports.HUALite = HUALite;
// ===== 정적 메서드 =====
(function (HUALite) {
    // 정적 API 키 발급
    async function issueKey(baseUrl) {
        const client = new client_1.HUALiteClient('dummy', { baseUrl });
        return client.issueKey();
    }
    HUALite.issueKey = issueKey;
    // 검증 유틸리티
    function validateApiKey(apiKey) {
        return Boolean(apiKey && apiKey.trim().length > 0 && apiKey.startsWith('hua_'));
    }
    HUALite.validateApiKey = validateApiKey;
    // 프리셋 정보
    HUALite.presets = {
        tones: PRESET_INFO,
        modes: MODE_INFO,
        tiers: TIER_INFO
    };
    // 상수
    HUALite.constants = {
        TONE_PRESETS: types_1.TONE_PRESETS,
        MODE_PRESETS: types_1.MODE_PRESETS,
        TIER_PRESETS: types_1.TIER_PRESETS,
        SUPPORTED_LANGS: types_1.SUPPORTED_LANGS,
        LLM_PROVIDERS: types_1.LLM_PROVIDERS
    };
})(HUALite || (exports.HUALite = HUALite = {}));
// ===== 타입 재내보내기 =====
__exportStar(require("./types"), exports);
var errors_1 = require("./errors");
Object.defineProperty(exports, "HUAError", { enumerable: true, get: function () { return errors_1.HUAError; } });
Object.defineProperty(exports, "MissingApiKeyError", { enumerable: true, get: function () { return errors_1.MissingApiKeyError; } });
Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
Object.defineProperty(exports, "ServerError", { enumerable: true, get: function () { return errors_1.ServerError; } });
Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
Object.defineProperty(exports, "InvalidApiKeyError", { enumerable: true, get: function () { return errors_1.InvalidApiKeyError; } });
Object.defineProperty(exports, "GuestKeyLimitExceededError", { enumerable: true, get: function () { return errors_1.GuestKeyLimitExceededError; } });
Object.defineProperty(exports, "RateLimitExceededError", { enumerable: true, get: function () { return errors_1.RateLimitExceededError; } });
Object.defineProperty(exports, "InsufficientCreditsError", { enumerable: true, get: function () { return errors_1.InsufficientCreditsError; } });
Object.defineProperty(exports, "MissingMessageError", { enumerable: true, get: function () { return errors_1.MissingMessageError; } });
Object.defineProperty(exports, "InvalidToneError", { enumerable: true, get: function () { return errors_1.InvalidToneError; } });
Object.defineProperty(exports, "InvalidModeError", { enumerable: true, get: function () { return errors_1.InvalidModeError; } });
Object.defineProperty(exports, "InvalidTierError", { enumerable: true, get: function () { return errors_1.InvalidTierError; } });
Object.defineProperty(exports, "InvalidLanguageError", { enumerable: true, get: function () { return errors_1.InvalidLanguageError; } });
Object.defineProperty(exports, "OpenAIApiError", { enumerable: true, get: function () { return errors_1.OpenAIApiError; } });
Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: function () { return errors_1.ConfigurationError; } });
Object.defineProperty(exports, "RetryLimitExceededError", { enumerable: true, get: function () { return errors_1.RetryLimitExceededError; } });
Object.defineProperty(exports, "createErrorFromResponse", { enumerable: true, get: function () { return errors_1.createErrorFromResponse; } });
Object.defineProperty(exports, "isHUAError", { enumerable: true, get: function () { return errors_1.isHUAError; } });
Object.defineProperty(exports, "isRetryableError", { enumerable: true, get: function () { return errors_1.isRetryableError; } });
Object.defineProperty(exports, "formatErrorMessage", { enumerable: true, get: function () { return errors_1.formatErrorMessage; } });
// ===== 기본 내보내기 =====
exports.default = HUALite;