deliveryapi 0.1.4 → 0.2.1

package/dist/index.d.cts

@@ -1,465 +1,444 @@
-// Generated by dts-bundle-generator v9.5.1
+interface ApiResponse<T = unknown> {
+    isSuccess: boolean;
+    data?: T;
+    message?: string;
+    error?: string;
+    statusCode?: number;
+    errorCode?: string;
+}
+interface RequestVerificationParams {
+    email: string;
+}
+interface VerifyAndRegisterParams {
+    email: string;
+    code: string;
+    password: string;
+    displayName: string;
+}
+interface VerifyAndRegisterResult {
+    customToken: string;
+}
+interface EnsureUserResult {
+    uid: string;
+    email: string;
+    displayName: string;
+    isNewUser: boolean;
+}
+interface DashboardApiKey {
+    name: string;
+    status: string;
+    environment: string;
+    secretKeyCount: number;
+    usage: {
+        today: number;
+        thisMonth: number;
+    };
+}
+interface DashboardResult {
+    user: {
+        email: string;
+        displayName: string;
+    };
+    customer: {
+        totalRequests: number;
+    } | null;
+    apiKeys: DashboardApiKey[];
+    plan: {
+        name: string;
+        tier: string;
+        limits: {
+            requestsPerMinute: number;
+            requestsPerMonth: number;
+        };
+    };
+}
+interface IssueApiKeyResult {
+    apiKey: string;
+    secretKey: string;
+    emailSent: boolean;
+}
+interface Post {
+    id: string;
+    title: string;
+    content?: string;
+    authorUid: string;
+    authorName: string;
+    isSecret: boolean;
+    commentCount: number;
+    viewCount: number;
+    dateCreated: string | null;
+    dateModified?: string | null;
+}
+interface Comment {
+    id: string;
+    postId?: string;
+    content: string;
+    authorUid: string;
+    authorName: string;
+    isAdmin: boolean;
+    dateCreated: string | null;
+}
+interface ListPostsParams {
+    cursor?: string;
+    pageSize?: number;
+}
+interface ListPostsResult {
+    posts: Post[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+interface CreatePostParams {
+    title: string;
+    content: string;
+    isSecret?: boolean;
+}
+interface UpdatePostParams {
+    title?: string;
+    content?: string;
+    isSecret?: boolean;
+}
+interface ListCommentsResult {
+    comments: Comment[];
+}
+interface CreateCommentParams {
+    content: string;
+}
+interface ContactInquiryParams {
+    name: string;
+    email: string;
+    phone?: string;
+    projectType: string;
+    budget?: string;
+    timeline?: string;
+    description: string;
+}
+interface PlanInfo {
+    tier: string;
+    name: string;
+    price: number;
+    limits: {
+        secretKey: {
+            maxRequestsPerMinute: number;
+            maxRequestsPerMonth: number;
+        };
+    };
+}
+interface SecretPreset {
+    id: string;
+    name: string;
+    description: string;
+}
+interface AdminStats {
+    totalHpUsers: number;
+    totalCustomers: number;
+    totalApiKeys: number;
+    totalRequests: number;
+    todaySignups: number;
+    planCounts: Record<string, number>;
+}
+interface DailySignup {
+    date: string;
+    count: number;
+}
+interface AdminUser {
+    uid: string;
+    email: string;
+    displayName: string;
+    provider: string;
+    currentPlan: string;
+    isAdmin: boolean;
+    dateCreated: string | null;
+}
+interface ListAdminUsersResult {
+    users: AdminUser[];
+    total: number;
+}
+interface UpdateAdminUserParams {
+    displayName?: string;
+    currentPlan?: string;
+    isAdmin?: boolean;
+}
+interface AdminSecretKeyDetail {
+    secretKeyHash: string;
+    name: string;
+    status: string;
+    usage: string;
+    limits: {
+        requestsPerMinute: number;
+        requestsPerHour: number;
+        requestsPerDay: number;
+        requestsPerMonth: number;
+        byOperation: {
+            total: {
+                requestsPerMinute: number;
+                requestsPerHour: number;
+                requestsPerDay: number;
+                requestsPerMonth: number;
+            };
+            read: {
+                requestsPerMinute: number;
+                requestsPerHour: number;
+                requestsPerDay: number;
+                requestsPerMonth: number;
+            };
+            write: {
+                requestsPerMinute: number;
+                requestsPerHour: number;
+                requestsPerDay: number;
+                requestsPerMonth: number;
+            };
+        } | null;
+    };
+    todayCount: number;
+    thisMonthCount: number;
+}
+interface AdminApiKeyDetail {
+    apiKeyHash: string;
+    apiKey: string;
+    name: string;
+    status: string;
+    environment: string;
+    planTier: string;
+    secretKeys: AdminSecretKeyDetail[];
+    usage: {
+        today: number;
+        thisMonth: number;
+    };
+}
+interface AdminUserDetail {
+    user: {
+        uid: string;
+        email: string;
+        displayName: string;
+        provider: string;
+        currentPlan: string;
+        isAdmin: boolean;
+        customerId: string | null;
+        dateCreated: string | null;
+    };
+    apiKeys: AdminApiKeyDetail[];
+    planLimits: {
+        name: string;
+        maxRequestsPerMinute: number;
+        maxRequestsPerHour: number;
+        maxRequestsPerDay: number;
+        maxRequestsPerMonth: number;
+    };
+}
+interface AdminCustomer {
+    id: string;
+    email: string;
+    currentPlan: string;
+    status: string;
+    activeApiKeys: number;
+    totalRequests: number;
+    dateCreated: string | null;
+}
+interface ListAdminCustomersResult {
+    customers: AdminCustomer[];
+    total: number;
+}
+interface AdminKeyItem {
+    apiKeyHash: string;
+    apiKey: string;
+    name: string;
+    status: string;
+    environment: string;
+    planTier: string;
+    customerEmail: string;
+    hpUserId: string | null;
+    secretKeyCount: number;
+    todayCount: number;
+    thisMonthCount: number;
+    dateCreated: string | null;
+}
+interface ListAdminKeysResult {
+    keys: AdminKeyItem[];
+    total: number;
+}
+interface UpdateKeyPlanParams {
+    planTier: string;
+}
+interface BulkUpdateKeyPlanParams {
+    apiKeyHashes: string[];
+    planTier: string;
+}
+interface KeyLimits {
+    requestsPerMinute?: number;
+    requestsPerHour?: number;
+    requestsPerDay?: number;
+    requestsPerMonth?: number;
+    byOperation?: {
+        total?: {
+            requestsPerMinute?: number;
+            requestsPerHour?: number;
+            requestsPerDay?: number;
+            requestsPerMonth?: number;
+        };
+        read?: {
+            requestsPerMinute?: number;
+            requestsPerHour?: number;
+            requestsPerDay?: number;
+            requestsPerMonth?: number;
+        };
+        write?: {
+            requestsPerMinute?: number;
+            requestsPerHour?: number;
+            requestsPerDay?: number;
+            requestsPerMonth?: number;
+        };
+    };
+}
+interface UpdateKeyLimitsParams {
+    secretKeyHash: string;
+    limits: KeyLimits;
+}
+interface AdminDemoKey {
+    apiKeyHash: string;
+    apiKey: string;
+    secretKey?: string;
+    name: string;
+    status: string;
+    environment: string;
+    planTier: string;
+    dateCreated: string | null;
+}
+interface CreateDemoKeyParams {
+    name?: string;
+    planTier?: string;
+}
+interface ListAdminDemoKeysResult {
+    keys: AdminDemoKey[];
+}
+interface TrackingLog {
+    id: string;
+    apiKeyHash: string;
+    customerEmail: string;
+    trackingNumber: string;
+    courierCode: string;
+    status: string;
+    dateCreated: string;
+}
+interface ListTrackingLogsResult {
+    logs: TrackingLog[];
+    total: number;
+    page: number;
+    totalPages: number;
+}
+interface HomepageClientOptions {
+    /** API base URL (e.g. 'https://api.deliveryapi.co.kr') */
+    baseUrl: string;
+    /** Returns Firebase ID Token for authenticated requests */
+    getToken?: () => Promise<string | null>;
+}
+
+declare class AuthResource {
+    private readonly baseUrl;
+    private readonly getToken;
+    constructor(baseUrl: string, getToken: () => Promise<string | null>);
+    /** Step 1: 이메일 인증 코드 요청 */
+    requestVerification(params: RequestVerificationParams): Promise<void>;
+    /** Step 2: 인증 코드 검증 + Firebase 계정 생성 → customToken 반환 */
+    verifyAndRegister(params: VerifyAndRegisterParams): Promise<VerifyAndRegisterResult>;
+    /** Google 로그인 후 HP 사용자 문서 확인/생성 */
+    ensureUser(): Promise<EnsureUserResult>;
+}
+
+declare class DashboardResource {
+    private readonly baseUrl;
+    private readonly getToken;
+    constructor(baseUrl: string, getToken: () => Promise<string | null>);
+    /** 대시보드 데이터 조회 (API 키 목록, 사용량, 플랜 정보) */
+    get(): Promise<DashboardResult>;
+    /** API 키 발급 */
+    issueKey(): Promise<IssueApiKeyResult>;
+}
+
+declare class QnaResource {
+    private readonly baseUrl;
+    private readonly getToken;
+    constructor(baseUrl: string, getToken: () => Promise<string | null>);
+    /** 게시글 목록 조회 (비회원도 공개글 열람 가능) */
+    listPosts(params?: ListPostsParams): Promise<ListPostsResult>;
+    /** 게시글 상세 조회 */
+    getPost(postId: string): Promise<Post>;
+    /** 게시글 작성 (로그인 필요) */
+    createPost(params: CreatePostParams): Promise<{
+        id: string;
+    }>;
+    /** 게시글 수정 (작성자/관리자만) */
+    updatePost(postId: string, params: UpdatePostParams): Promise<Post>;
+    /** 게시글 삭제 (작성자/관리자만) */
+    deletePost(postId: string): Promise<void>;
+    /** 댓글 목록 조회 */
+    listComments(postId: string): Promise<ListCommentsResult>;
+    /** 댓글 작성 (로그인 필요) */
+    createComment(postId: string, params: CreateCommentParams): Promise<Comment>;
+    /** 댓글 삭제 (작성자/관리자만) */
+    deleteComment(commentId: string): Promise<void>;
+}
+
+declare class AdminResource {
+    private readonly baseUrl;
+    private readonly getToken;
+    constructor(baseUrl: string, getToken: () => Promise<string | null>);
+    private token;
+    /** 전체 통계 조회 */
+    getStats(): Promise<AdminStats>;
+    /** 최근 14일 일별 가입자 수 */
+    getDailySignups(): Promise<DailySignup[]>;
+    /** 사용자 목록 조회 */
+    listUsers(): Promise<ListAdminUsersResult>;
+    /** 사용자 정보 수정 */
+    updateUser(uid: string, params: UpdateAdminUserParams): Promise<void>;
+    /** 사용자 상세 조회 (API 키 + 사용량 포함) */
+    getUserDetail(uid: string): Promise<AdminUserDetail>;
+    /** customers 목록 조회 */
+    listCustomers(): Promise<ListAdminCustomersResult>;
+    /** API 키 목록 조회 */
+    listKeys(): Promise<ListAdminKeysResult>;
+    /** API 키 플랜 변경 */
+    updateKeyPlan(apiKeyHash: string, params: UpdateKeyPlanParams): Promise<void>;
+    /** API 키 플랜 일괄 변경 */
+    bulkUpdateKeyPlan(params: BulkUpdateKeyPlanParams): Promise<void>;
+    /** Secret Key limits 수정 */
+    updateKeyLimits(apiKeyHash: string, params: UpdateKeyLimitsParams): Promise<void>;
+    /** 데모 키 생성 */
+    createDemoKey(params?: CreateDemoKeyParams): Promise<AdminDemoKey>;
+    /** 데모 키 목록 조회 */
+    listDemoKeys(): Promise<ListAdminDemoKeysResult>;
+    /** 데모 키 비활성화 */
+    deactivateDemoKey(apiKeyHash: string): Promise<void>;
+    /** 데모 키 활성화 */
+    activateDemoKey(apiKeyHash: string): Promise<void>;
+    /** 조회 로그 목록 */
+    listTrackingLogs(page?: number): Promise<ListTrackingLogsResult>;
+}
 
-declare class HttpClient {
-	private readonly baseUrl;
-	private readonly authHeader;
-	constructor(apiKey: string, secretKey: string, baseUrl: string);
-	get<T>(path: string, params?: Record<string, string>): Promise<T>;
-	post<T>(path: string, body?: unknown): Promise<T>;
-	put<T>(path: string, body?: unknown): Promise<T>;
-	patch<T>(path: string, body?: unknown): Promise<T>;
-	delete<T>(path: string): Promise<T>;
-	private request;
-}
-/**
- * Firebase Timestamp 호환 인터페이스
- * firebase-admin/firestore 및 firebase/firestore의 Timestamp와 구조적으로 호환됨
- */
-export interface Timestamp {
-	seconds: number;
-	nanoseconds: number;
-	toDate(): Date;
-	toMillis(): number;
-	isEqual(other: Timestamp): boolean;
-	valueOf(): string;
-}
-/**
- * 통일된 API 응답 형식
- */
-export interface ApiResponse<T = unknown> {
-	isSuccess: boolean;
-	statusCode?: number;
-	data?: T;
-	error?: string;
-	message?: string;
-}
-/**
- * 택배 배송 상태 열거형
- * 모든 택배사의 상태를 통합하여 정규화
- *
- * 📌 프로젝트별 차이점:
- * - delivery-saas-api-functions (이 프로젝트): enum만 정의 (데이터 반환용)
- * - farmsns-admin_new, farmsns-functions_new, farmfree-mobile:
- *   → CourierDeliveryStatusLabels (한글 라벨)
- *   → LotteStatusMapping, CJStatusMapping (택배사별 매핑)
- *   → Helper 함수들 (mapCourierStatus, isDeliveryInProgress 등)
- *
- * 이유: delivery-saas-api는 외부 API 역할로 데이터 반환만 수행하므로
- *       UI 표시용 라벨이나 변환 로직이 불필요
- */
-export declare enum CourierDeliveryStatus {
-	PENDING = "PENDING",// 접수 대기
-	REGISTERED = "REGISTERED",// 접수 완료
-	PICKUP_READY = "PICKUP_READY",// 집하 준비
-	PICKED_UP = "PICKED_UP",// 집하 완료
-	IN_TRANSIT = "IN_TRANSIT",// 배송 중
-	OUT_FOR_DELIVERY = "OUT_FOR_DELIVERY",// 배송 출발
-	DELIVERED = "DELIVERED",// 배송 완료
-	FAILED = "FAILED",// 배송 실패
-	RETURNED = "RETURNED",// 반송
-	CANCELLED = "CANCELLED",// 취소
-	HOLD = "HOLD",// 보류
-	UNKNOWN = "UNKNOWN"
-}
-declare const COURIER_CODES: {
-	readonly LOTTE: "lotte";
-	readonly CJ: "cj";
-	readonly POST: "post";
-	readonly HANJIN: "hanjin";
-	readonly LOGEN: "logen";
-	readonly GSPOSTBOX: "gspostbox";
-	readonly ILYANG: "ilyang";
-	readonly KYUNGDONG: "kyungdong";
-	readonly DAESIN: "daesin";
-	readonly HAPDONG: "hapdong";
-	readonly COUPANG: "coupang";
-};
-export type CourierCode = (typeof COURIER_CODES)[keyof typeof COURIER_CODES];
-/**
- * 인증 방식 타입
- */
-export type AuthMethod = "2FA_SMS" | "2FA_EMAIL" | "2FA_KAKAO" | "2FA_OTP";
-/**
- * 인증 코드 타입
- */
-export type AuthCodeType = "NUMERIC" | "ALPHANUMERIC";
-/**
- * 택배사 정보 인터페이스
- */
-export interface CourierInfo {
-	id: CourierCode;
-	trackingApiCode: CourierCode;
-	displayName: string;
-	icon: string;
-	supportsTracking: boolean;
-	supportsAccount: boolean;
-	adminUrl: string;
-	trackingUrl: string;
-	customerServicePhone: string;
-	requires2FA: boolean;
-	authMethod?: AuthMethod | null;
-	authCodeLength?: number | null;
-	authCodeType?: AuthCodeType | null;
-	supportsAutoReauth: boolean;
-	allowsMultipleSessions: boolean;
-	reauthMessage: string;
-	accessTokenDurationMinutes: number;
-	maxInquiryDays: number;
-}
-/**
- * 개별 택배 조회 항목
- */
-export interface TrackingItem {
-	id?: string;
-	clientId?: string;
-	courierCode: string;
-	trackingNumber: string;
-}
-/**
- * 택배 진행 상황
- */
-export interface TrackingProgress {
-	dateTime: string;
-	location: string;
-	status: string;
-	statusCode?: CourierDeliveryStatus;
-	description?: string;
-	telno?: string;
-	telno2?: string;
-}
-/**
- * 통합 택배 조회 응답
- */
-export interface UnifiedTrackingResponse {
-	trackingNumber: string;
-	courierCode: string;
-	courierName: string;
-	deliveryStatus: CourierDeliveryStatus;
-	deliveryStatusText: string;
-	isDelivered: boolean;
-	senderName?: string;
-	receiverName?: string;
-	receiverAddress?: string;
-	productName?: string;
-	productQuantity?: number;
-	dateDelivered?: string;
-	dateEstimated?: string;
-	dateLastProgress: string;
-	progresses: TrackingProgress[];
-	queriedAt: string;
-}
-/**
- * 택배 조회 에러 코드
- *
- * 과금 정책:
- * - NOT_FOUND만 과금 (택배사 API를 호출했으나 데이터 없음 = 사용자 책임)
- * - 나머지는 비과금 (요청 검증 실패 또는 시스템 오류)
- */
-export type TrackingErrorCode = "MISSING_PARAMS" | "INVALID_TRACKING_NUMBER" | "UNSUPPORTED_COURIER" | "NOT_FOUND" | "TRACKING_FAILED";
-/**
- * 택배 조회 오류
- */
-export interface TrackingError {
-	code: TrackingErrorCode;
-	message: string;
-	courierCode?: string;
-	trackingNumber?: string;
-	details?: unknown;
-	billable: boolean;
-}
-/**
- * 캐시 메타데이터
- */
-export interface TrackingCacheInfo {
-	fromCache: boolean;
-	cachedAt?: string;
-}
-/**
- * 개별 택배 조회 결과
- */
-export interface TrackingResult {
-	id?: string;
-	clientId?: string;
-	success: boolean;
-	data?: UnifiedTrackingResponse;
-	error?: TrackingError;
-	cache?: TrackingCacheInfo;
-}
-/**
- * 택배 조회 응답 (배열로 다건 응답)
- */
-export interface TrackingResponse {
-	results: TrackingResult[];
-	summary: {
-		total: number;
-		successful: number;
-		failed: number;
-		billable: number;
-	};
-}
-/**
- * 웹훅 엔드포인트 (apiKeys 문서에 저장)
- * API Key당 최대 10개 등록 가능
- */
-export interface WebhookEndpoint {
-	id: string;
-	url: string;
-	name?: string;
-	webhookSecret: string;
-	webhookSecretHash: string;
-	status: "active" | "inactive";
-	dateCreated: Timestamp;
-	dateModified: Timestamp;
-}
-/**
- * 구독 상태
- */
-export type SubscriptionStatus = "active" | "completed" | "cancelled" | "failed";
-/**
- * 택배 조회 구독 (trackingSubscriptions 컬렉션)
- */
-export interface TrackingSubscription {
-	id: string;
-	clientId?: string;
-	customerId: string;
-	apiKeyHash: string;
-	courierCode: string;
-	trackingNumber: string;
-	endpointId: string;
-	subscribedStatuses: CourierDeliveryStatus[];
-	currentStatus: CourierDeliveryStatus;
-	lastPolledAt: Timestamp;
-	nextPollAt: Timestamp;
-	status: SubscriptionStatus;
-	failureCount: number;
-	metadata?: Record<string, string>;
-	dateCreated: Timestamp;
-	dateModified: Timestamp;
-}
-/**
- * 웹훅 페이로드
- */
-export interface WebhookPayload {
-	event: "tracking.status_changed";
-	subscriptionId: string;
-	timestamp: string;
-	data: {
-		courierCode: string;
-		trackingNumber: string;
-		previousStatus?: CourierDeliveryStatus;
-		currentStatus: CourierDeliveryStatus;
-		tracking: UnifiedTrackingResponse;
-	};
-	metadata?: Record<string, string>;
-}
-export interface DeliverySaasClientConfig {
-	/** API Key (발급받은 API Key) */
-	apiKey: string;
-	/** Secret Key (발급받은 Secret Key) */
-	secretKey: string;
-	/** API Base URL (기본값: https://api.deliveryapi.co.kr) */
-	baseUrl?: string;
-}
-export interface TrackingRequestInput {
-	items: TrackingItem[];
-	includeProgresses?: boolean;
-}
-export interface SubscriptionCreateInput {
-	courierCode: string;
-	trackingNumber: string;
-	endpointId: string;
-	subscribedStatuses?: CourierDeliveryStatus[];
-	id?: string;
-	metadata?: Record<string, string>;
-}
-export interface SubscriptionCreateResult {
-	id?: string;
-	courierCode: string;
-	trackingNumber: string;
-	subscriptionId?: string;
-	success: boolean;
-	currentStatus?: CourierDeliveryStatus;
-	error?: string;
-}
-export interface SubscriptionCreateBatchResult {
-	results: SubscriptionCreateResult[];
-	summary: {
-		total: number;
-		successful: number;
-		failed: number;
-	};
-}
-export interface SubscriptionListResult {
-	subscriptions: {
-		id: string;
-		courierCode: string;
-		trackingNumber: string;
-		endpointId: string;
-		subscribedStatuses: CourierDeliveryStatus[];
-		currentStatus: CourierDeliveryStatus;
-		status: "active" | "completed" | "cancelled" | "failed";
-		metadata?: Record<string, string>;
-		dateCreated: string;
-		dateModified: string;
-	}[];
-	total: number;
-	nextCursor?: string;
-}
-export interface WebhookCreateInput {
-	url: string;
-	name?: string;
-}
-export interface WebhookCreateResult {
-	endpointId: string;
-	url: string;
-	name?: string;
-	webhookSecret: string;
-	dateCreated: string;
-}
-export interface WebhookUpdateInput {
-	name: string;
-}
-export interface WebhookListResult {
-	endpoints: WebhookEndpoint[];
-	total: number;
-}
-export interface WebhookRotateSecretResult {
-	webhookSecret: string;
-}
-export interface CourierListResult {
-	couriers: CourierInfo[];
-}
-declare class TrackingResource {
-	private readonly http;
-	constructor(http: HttpClient);
-	/**
-	 * 택배 조회 (공개 API, 계정 불필요)
-	 * @param items 조회할 택배 목록 (1건도 배열로)
-	 * @param includeProgresses 진행 내역 포함 여부 (기본값: true)
-	 */
-	get(items: TrackingRequestInput["items"], includeProgresses?: boolean): Promise<TrackingResponse>;
-	/**
-	 * 단건 택배 조회 (편의 메서드)
-	 */
-	getOne(courierCode: string, trackingNumber: string, options?: {
-		clientId?: string;
-		includeProgresses?: boolean;
-	}): Promise<TrackingResponse>;
-}
-declare class SubscriptionsResource {
-	private readonly http;
-	constructor(http: HttpClient);
-	/**
-	 * 택배 구독 생성 (단건)
-	 * 상태 변경 시 등록된 웹훅 엔드포인트로 알림 전송
-	 */
-	create(data: SubscriptionCreateInput): Promise<SubscriptionCreateBatchResult>;
-	/**
-	 * 택배 구독 일괄 생성 (최대 100건)
-	 */
-	createBatch(items: SubscriptionCreateInput[]): Promise<SubscriptionCreateBatchResult>;
-	/**
-	 * 택배 구독 목록 조회
-	 */
-	list(options?: {
-		status?: "active" | "completed" | "cancelled" | "failed";
-		limit?: number;
-		cursor?: string;
-	}): Promise<SubscriptionListResult>;
-	/**
-	 * 택배 구독 상세 조회
-	 */
-	retrieve(subscriptionId: string): Promise<SubscriptionListResult["subscriptions"][number]>;
-	/**
-	 * 택배 구독 취소 (ID)
-	 */
-	cancel(subscriptionId: string): Promise<void>;
-	/**
-	 * 택배 구독 취소 (송장번호)
-	 */
-	cancelByTracking(courierCode: string, trackingNumber: string): Promise<{
-		cancelledCount: number;
-	}>;
-}
-declare class WebhooksResource {
-	private readonly http;
-	constructor(http: HttpClient);
-	/**
-	 * 웹훅 엔드포인트 등록
-	 */
-	create(data: WebhookCreateInput): Promise<WebhookCreateResult>;
-	/**
-	 * 웹훅 엔드포인트 목록 조회
-	 */
-	list(): Promise<WebhookListResult>;
-	/**
-	 * 웹훅 엔드포인트 이름 수정
-	 */
-	update(endpointId: string, data: WebhookUpdateInput): Promise<void>;
-	/**
-	 * 웹훅 엔드포인트 삭제
-	 */
-	delete(endpointId: string): Promise<void>;
-	/**
-	 * 웹훅 시크릿 재발급
-	 */
-	rotateSecret(endpointId: string, webhookSecret?: string): Promise<WebhookRotateSecretResult>;
-}
-declare class CouriersResource {
-	private readonly http;
-	constructor(http: HttpClient);
-	/**
-	 * 지원 택배사 목록 조회
-	 */
-	list(): Promise<CourierListResult>;
-}
-/**
- * DeliverySaaS API Client
- *
- * @example
- * ```typescript
- * import { DeliverySaasClient } from 'deliveryapi'
- *
- * const client = new DeliverySaasClient({
- *   apiKey: 'your-api-key',
- *   secretKey: 'your-secret-key',
- * })
- *
- * // 택배 조회
- * const result = await client.tracking.getOne('LOTTE', '1234567890')
- *
- * // 구독 생성
- * const subscription = await client.subscriptions.create({
- *   courierCode: 'LOTTE',
- *   trackingNumber: '1234567890',
- *   endpointId: 'ep_xxx',
- * })
- * ```
- */
-export declare class DeliverySaasClient {
-	readonly tracking: TrackingResource;
-	readonly subscriptions: SubscriptionsResource;
-	readonly webhooks: WebhooksResource;
-	readonly couriers: CouriersResource;
-	constructor(config: DeliverySaasClientConfig);
-}
-export declare class DeliverySaasError extends Error {
-	readonly statusCode: number;
-	readonly code?: string | undefined;
-	constructor(message: string, statusCode: number, code?: string | undefined);
-}
-export declare class AuthenticationError extends DeliverySaasError {
-	constructor(message?: string);
-}
-export declare class RateLimitError extends DeliverySaasError {
-	constructor(message?: string);
-}
-export declare class NotFoundError extends DeliverySaasError {
-	constructor(message?: string);
+declare class PublicResource {
+    private readonly baseUrl;
+    constructor(baseUrl: string);
+    /** 요금제 목록 조회 */
+    getPlans(): Promise<PlanInfo[]>;
+    /** Secret Key 프리셋 목록 조회 */
+    getSecretPresets(): Promise<SecretPreset[]>;
+    /** 개발 의뢰 문의 전송 */
+    sendContactInquiry(params: ContactInquiryParams): Promise<void>;
 }
 
-export {
-	TrackingItem as TrackingResponseItem,
-};
+declare class HomepageClient {
+    readonly auth: AuthResource;
+    readonly dashboard: DashboardResource;
+    readonly qna: QnaResource;
+    readonly admin: AdminResource;
+    readonly public: PublicResource;
+    constructor(options: HomepageClientOptions);
+}
+
+declare class ApiError extends Error {
+    readonly statusCode: number;
+    readonly errorCode: string | undefined;
+    constructor(statusCode: number, errorCode: string | undefined, message: string);
+}
 
-export {};
+export { type AdminApiKeyDetail, type AdminCustomer, type AdminDemoKey, type AdminKeyItem, type AdminSecretKeyDetail, type AdminStats, type AdminUser, type AdminUserDetail, ApiError, type ApiResponse, type BulkUpdateKeyPlanParams, type Comment, type ContactInquiryParams, type CreateCommentParams, type CreateDemoKeyParams, type CreatePostParams, type DailySignup, type DashboardApiKey, type DashboardResult, type EnsureUserResult, HomepageClient, type HomepageClientOptions, type IssueApiKeyResult, type KeyLimits, type ListAdminCustomersResult, type ListAdminDemoKeysResult, type ListAdminKeysResult, type ListAdminUsersResult, type ListCommentsResult, type ListPostsParams, type ListPostsResult, type ListTrackingLogsResult, type PlanInfo, type Post, type RequestVerificationParams, type SecretPreset, type TrackingLog, type UpdateAdminUserParams, type UpdateKeyLimitsParams, type UpdateKeyPlanParams, type UpdatePostParams, type VerifyAndRegisterParams, type VerifyAndRegisterResult };