deliveryapi 0.1.4 → 0.2.0

package/dist/index.js

@@ -1,226 +1,309 @@
-// src/errors.ts
-var DeliverySaasError = class extends Error {
-  constructor(message, statusCode, code) {
+// src/http.ts
+var ApiError = class extends Error {
+  constructor(statusCode, errorCode, message) {
     super(message);
     this.statusCode = statusCode;
-    this.code = code;
-    this.name = "DeliverySaasError";
-  }
-};
-var AuthenticationError = class extends DeliverySaasError {
-  constructor(message = "Invalid API key or secret key") {
-    super(message, 401, "AUTHENTICATION_ERROR");
-    this.name = "AuthenticationError";
+    this.errorCode = errorCode;
+    this.name = "ApiError";
   }
 };
-var RateLimitError = class extends DeliverySaasError {
-  constructor(message = "Rate limit exceeded") {
-    super(message, 429, "RATE_LIMIT_ERROR");
-    this.name = "RateLimitError";
+async function request(baseUrl, path, options = {}) {
+  const { token, ...fetchOptions } = options;
+  const headers = {
+    "Content-Type": "application/json",
+    ...fetchOptions.headers
+  };
+  if (token) {
+    headers["Authorization"] = `Bearer ${token}`;
   }
-};
-var NotFoundError = class extends DeliverySaasError {
-  constructor(message = "Resource not found") {
-    super(message, 404, "NOT_FOUND");
-    this.name = "NotFoundError";
+  const res = await fetch(`${baseUrl}${path}`, {
+    ...fetchOptions,
+    headers
+  });
+  const body = await res.json();
+  if (!res.ok || !body.isSuccess) {
+    throw new ApiError(
+      res.status,
+      body.errorCode,
+      body.error ?? `Request failed with status ${res.status}`
+    );
   }
-};
+  return body.data;
+}
 
-// src/http.ts
-var HttpClient = class {
-  constructor(apiKey, secretKey, baseUrl) {
-    this.baseUrl = baseUrl.replace(/\/$/, "");
-    this.authHeader = `Bearer ${apiKey}:${secretKey}`;
-  }
-  async get(path, params) {
-    const url = new URL(`${this.baseUrl}${path}`);
-    if (params) {
-      Object.entries(params).forEach(([key, value]) => url.searchParams.set(key, value));
-    }
-    return this.request("GET", url.toString());
-  }
-  async post(path, body) {
-    return this.request("POST", `${this.baseUrl}${path}`, body);
-  }
-  async put(path, body) {
-    return this.request("PUT", `${this.baseUrl}${path}`, body);
-  }
-  async patch(path, body) {
-    return this.request("PATCH", `${this.baseUrl}${path}`, body);
-  }
-  async delete(path) {
-    return this.request("DELETE", `${this.baseUrl}${path}`);
-  }
-  async request(method, url, body) {
-    const headers = {
-      Authorization: this.authHeader,
-      "Content-Type": "application/json"
-    };
-    const response = await fetch(url, {
-      method,
-      headers,
-      body: body !== void 0 ? JSON.stringify(body) : void 0
-    });
-    const json = await response.json();
-    if (!response.ok) {
-      if (response.status === 401) throw new AuthenticationError(json.message);
-      if (response.status === 404) throw new NotFoundError(json.message);
-      if (response.status === 429) throw new RateLimitError(json.message);
-      throw new DeliverySaasError(json.message ?? "Request failed", response.status, json.error);
-    }
-    if (!json.isSuccess) {
-      throw new DeliverySaasError(json.message ?? "API returned failure", response.status, json.error);
-    }
-    return json.data;
+// src/resources/auth.ts
+var AuthResource = class {
+  constructor(baseUrl, getToken) {
+    this.baseUrl = baseUrl;
+    this.getToken = getToken;
+  }
+  /** Step 1: 이메일 인증 코드 요청 */
+  async requestVerification(params) {
+    await request(this.baseUrl, "/v1/homepage/register/request", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /** Step 2: 인증 코드 검증 + Firebase 계정 생성 → customToken 반환 */
+  async verifyAndRegister(params) {
+    return request(this.baseUrl, "/v1/homepage/register/verify", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /** Google 로그인 후 HP 사용자 문서 확인/생성 */
+  async ensureUser() {
+    const token = await this.getToken();
+    return request(this.baseUrl, "/v1/homepage/ensure-user", {
+      method: "POST",
+      body: JSON.stringify({}),
+      token
+    });
   }
 };
 
-// src/resources/tracking.ts
-var TrackingResource = class {
-  constructor(http) {
-    this.http = http;
-  }
-  /**
-   * 택배 조회 (공개 API, 계정 불필요)
-   * @param items 조회할 택배 목록 (1건도 배열로)
-   * @param includeProgresses 진행 내역 포함 여부 (기본값: true)
-   */
-  async get(items, includeProgresses = true) {
-    return this.http.post("/v1/tracking/trace", {
-      items,
-      includeProgresses
-    });
-  }
-  /**
-   * 단건 택배 조회 (편의 메서드)
-   */
-  async getOne(courierCode, trackingNumber, options) {
-    return this.get(
-      [{ courierCode, trackingNumber, clientId: options?.clientId }],
-      options?.includeProgresses ?? true
-    );
+// src/resources/dashboard.ts
+var DashboardResource = class {
+  constructor(baseUrl, getToken) {
+    this.baseUrl = baseUrl;
+    this.getToken = getToken;
+  }
+  /** 대시보드 데이터 조회 (API 키 목록, 사용량, 플랜 정보) */
+  async get() {
+    const token = await this.getToken();
+    return request(this.baseUrl, "/v1/homepage/dashboard", { token });
+  }
+  /** API 키 발급 */
+  async issueKey() {
+    const token = await this.getToken();
+    return request(this.baseUrl, "/v1/homepage/dashboard/issue-key", {
+      method: "POST",
+      body: JSON.stringify({}),
+      token
+    });
   }
 };
 
-// src/resources/subscriptions.ts
-var SubscriptionsResource = class {
-  constructor(http) {
-    this.http = http;
-  }
-  /**
-   * 택배 구독 생성 (단건)
-   * 상태 변경 시 등록된 웹훅 엔드포인트로 알림 전송
-   */
-  async create(data) {
-    return this.http.post("/v1/tracking/subscriptions", {
-      items: [data]
-    });
-  }
-  /**
-   * 택배 구독 일괄 생성 (최대 100건)
-   */
-  async createBatch(items) {
-    return this.http.post("/v1/tracking/subscriptions", { items });
-  }
-  /**
-   * 택배 구독 목록 조회
-   */
-  async list(options) {
-    const params = {};
-    if (options?.status) params["status"] = options.status;
-    if (options?.limit) params["limit"] = String(options.limit);
-    if (options?.cursor) params["cursor"] = options.cursor;
-    return this.http.get("/v1/tracking/subscriptions", params);
-  }
-  /**
-   * 택배 구독 상세 조회
-   */
-  async retrieve(subscriptionId) {
-    return this.http.get(`/v1/tracking/subscriptions/${subscriptionId}`);
-  }
-  /**
-   * 택배 구독 취소 (ID)
-   */
-  async cancel(subscriptionId) {
-    await this.http.delete(`/v1/tracking/subscriptions/${subscriptionId}`);
-  }
-  /**
-   * 택배 구독 취소 (송장번호)
-   */
-  async cancelByTracking(courierCode, trackingNumber) {
-    return this.http.delete(
-      `/v1/tracking/subscriptions?courierCode=${encodeURIComponent(courierCode)}&trackingNumber=${encodeURIComponent(trackingNumber)}`
-    );
+// src/resources/qna.ts
+var QnaResource = class {
+  constructor(baseUrl, getToken) {
+    this.baseUrl = baseUrl;
+    this.getToken = getToken;
+  }
+  /** 게시글 목록 조회 (비회원도 공개글 열람 가능) */
+  async listPosts(params = {}) {
+    const token = await this.getToken();
+    const qs = new URLSearchParams();
+    if (params.cursor) qs.set("cursor", params.cursor);
+    if (params.pageSize) qs.set("pageSize", String(params.pageSize));
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return request(this.baseUrl, `/v1/homepage/posts${query}`, { token });
+  }
+  /** 게시글 상세 조회 */
+  async getPost(postId) {
+    const token = await this.getToken();
+    return request(this.baseUrl, `/v1/homepage/posts/${postId}`, { token });
+  }
+  /** 게시글 작성 (로그인 필요) */
+  async createPost(params) {
+    const token = await this.getToken();
+    return request(this.baseUrl, "/v1/homepage/posts", {
+      method: "POST",
+      body: JSON.stringify(params),
+      token
+    });
+  }
+  /** 게시글 수정 (작성자/관리자만) */
+  async updatePost(postId, params) {
+    const token = await this.getToken();
+    return request(this.baseUrl, `/v1/homepage/posts/${postId}`, {
+      method: "PUT",
+      body: JSON.stringify(params),
+      token
+    });
+  }
+  /** 게시글 삭제 (작성자/관리자만) */
+  async deletePost(postId) {
+    const token = await this.getToken();
+    await request(this.baseUrl, `/v1/homepage/posts/${postId}`, {
+      method: "DELETE",
+      token
+    });
+  }
+  /** 댓글 목록 조회 */
+  async listComments(postId) {
+    const token = await this.getToken();
+    return request(this.baseUrl, `/v1/homepage/posts/${postId}/comments`, { token });
+  }
+  /** 댓글 작성 (로그인 필요) */
+  async createComment(postId, params) {
+    const token = await this.getToken();
+    return request(this.baseUrl, `/v1/homepage/posts/${postId}/comments`, {
+      method: "POST",
+      body: JSON.stringify(params),
+      token
+    });
+  }
+  /** 댓글 삭제 (작성자/관리자만) */
+  async deleteComment(commentId) {
+    const token = await this.getToken();
+    await request(this.baseUrl, `/v1/homepage/comments/${commentId}`, {
+      method: "DELETE",
+      token
+    });
   }
 };
 
-// src/resources/webhooks.ts
-var WebhooksResource = class {
-  constructor(http) {
-    this.http = http;
-  }
-  /**
-   * 웹훅 엔드포인트 등록
-   */
-  async create(data) {
-    return this.http.post("/v1/webhook-v2/endpoints", data);
-  }
-  /**
-   * 웹훅 엔드포인트 목록 조회
-   */
-  async list() {
-    return this.http.get("/v1/webhook-v2/endpoints");
-  }
-  /**
-   * 웹훅 엔드포인트 이름 수정
-   */
-  async update(endpointId, data) {
-    await this.http.put(`/v1/webhook-v2/endpoints/${endpointId}`, data);
-  }
-  /**
-   * 웹훅 엔드포인트 삭제
-   */
-  async delete(endpointId) {
-    await this.http.delete(`/v1/webhook-v2/endpoints/${endpointId}`);
-  }
-  /**
-   * 웹훅 시크릿 재발급
-   */
-  async rotateSecret(endpointId, webhookSecret) {
-    return this.http.post(
-      `/v1/webhook-v2/endpoints/${endpointId}/rotate`,
-      webhookSecret ? { webhookSecret } : void 0
+// src/resources/admin.ts
+var AdminResource = class {
+  constructor(baseUrl, getToken) {
+    this.baseUrl = baseUrl;
+    this.getToken = getToken;
+  }
+  async token() {
+    return this.getToken();
+  }
+  /** 전체 통계 조회 */
+  async getStats() {
+    return request(this.baseUrl, "/v1/homepage/admin/stats", {
+      token: await this.token()
+    });
+  }
+  /** 최근 14일 일별 가입자 수 */
+  async getDailySignups() {
+    return request(this.baseUrl, "/v1/homepage/admin/daily-signups", {
+      token: await this.token()
+    });
+  }
+  /** 사용자 목록 조회 */
+  async listUsers() {
+    return request(this.baseUrl, "/v1/homepage/admin/users", {
+      token: await this.token()
+    });
+  }
+  /** 사용자 정보 수정 */
+  async updateUser(uid, params) {
+    await request(this.baseUrl, `/v1/homepage/admin/users/${uid}`, {
+      method: "PATCH",
+      body: JSON.stringify(params),
+      token: await this.token()
+    });
+  }
+  /** 사용자 상세 조회 (API 키 + 사용량 포함) */
+  async getUserDetail(uid) {
+    return request(this.baseUrl, `/v1/homepage/admin/users/${uid}/detail`, {
+      token: await this.token()
+    });
+  }
+  /** customers 목록 조회 */
+  async listCustomers() {
+    return request(this.baseUrl, "/v1/homepage/admin/customers", {
+      token: await this.token()
+    });
+  }
+  /** API 키 목록 조회 */
+  async listKeys() {
+    return request(this.baseUrl, "/v1/homepage/admin/keys", {
+      token: await this.token()
+    });
+  }
+  /** API 키 플랜 변경 */
+  async updateKeyPlan(apiKeyHash, params) {
+    await request(this.baseUrl, `/v1/homepage/admin/keys/${apiKeyHash}/plan`, {
+      method: "PATCH",
+      body: JSON.stringify(params),
+      token: await this.token()
+    });
+  }
+  /** API 키 플랜 일괄 변경 */
+  async bulkUpdateKeyPlan(params) {
+    await request(this.baseUrl, "/v1/homepage/admin/keys/bulk/plan", {
+      method: "PATCH",
+      body: JSON.stringify(params),
+      token: await this.token()
+    });
+  }
+  /** Secret Key limits 수정 */
+  async updateKeyLimits(apiKeyHash, params) {
+    await request(this.baseUrl, `/v1/homepage/admin/keys/${apiKeyHash}/limits`, {
+      method: "PATCH",
+      body: JSON.stringify(params),
+      token: await this.token()
+    });
+  }
+  /** 데모 키 생성 */
+  async createDemoKey(params = {}) {
+    return request(this.baseUrl, "/v1/homepage/admin/demo-keys", {
+      method: "POST",
+      body: JSON.stringify(params),
+      token: await this.token()
+    });
+  }
+  /** 데모 키 목록 조회 */
+  async listDemoKeys() {
+    return request(this.baseUrl, "/v1/homepage/admin/demo-keys", {
+      token: await this.token()
+    });
+  }
+  /** 데모 키 비활성화 */
+  async deactivateDemoKey(apiKeyHash) {
+    await request(this.baseUrl, `/v1/homepage/admin/demo-keys/${apiKeyHash}/deactivate`, {
+      method: "PATCH",
+      body: JSON.stringify({}),
+      token: await this.token()
+    });
+  }
+  /** 데모 키 활성화 */
+  async activateDemoKey(apiKeyHash) {
+    await request(this.baseUrl, `/v1/homepage/admin/demo-keys/${apiKeyHash}/activate`, {
+      method: "PATCH",
+      body: JSON.stringify({}),
+      token: await this.token()
+    });
+  }
+  /** 조회 로그 목록 */
+  async listTrackingLogs(page = 1) {
+    return request(
+      this.baseUrl,
+      `/v1/homepage/admin/tracking-logs?page=${page}`,
+      { token: await this.token() }
     );
   }
 };
 
-// src/resources/couriers.ts
-var CouriersResource = class {
-  constructor(http) {
-    this.http = http;
+// src/resources/public.ts
+var PublicResource = class {
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl;
   }
-  /**
-   * 지원 택배사 목록 조회
-   */
-  async list() {
-    return this.http.get("/v1/tracking/couriers");
+  /** 요금제 목록 조회 */
+  async getPlans() {
+    return request(this.baseUrl, "/v1/homepage/plans");
+  }
+  /** Secret Key 프리셋 목록 조회 */
+  async getSecretPresets() {
+    return request(this.baseUrl, "/v1/homepage/secret-presets");
+  }
+  /** 개발 의뢰 문의 전송 */
+  async sendContactInquiry(params) {
+    await request(this.baseUrl, "/v1/homepage/contact/inquiry", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
   }
 };
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.deliveryapi.co.kr";
-var DeliverySaasClient = class {
-  constructor(config) {
-    const http = new HttpClient(
-      config.apiKey,
-      config.secretKey,
-      config.baseUrl ?? DEFAULT_BASE_URL
-    );
-    this.tracking = new TrackingResource(http);
-    this.subscriptions = new SubscriptionsResource(http);
-    this.webhooks = new WebhooksResource(http);
-    this.couriers = new CouriersResource(http);
+var noToken = async () => null;
+var HomepageClient = class {
+  constructor(options) {
+    const { baseUrl, getToken = noToken } = options;
+    this.auth = new AuthResource(baseUrl, getToken);
+    this.dashboard = new DashboardResource(baseUrl, getToken);
+    this.qna = new QnaResource(baseUrl, getToken);
+    this.admin = new AdminResource(baseUrl, getToken);
+    this.public = new PublicResource(baseUrl);
   }
 };
 
-export { AuthenticationError, DeliverySaasClient, DeliverySaasError, NotFoundError, RateLimitError };
+export { ApiError, HomepageClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deliveryapi",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Official JavaScript/TypeScript SDK for the DeliveryAPI",
   "keywords": [
     "delivery",
@@ -37,14 +37,11 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup && dts-bundle-generator --out-file dist/index.d.ts src/index.ts && cp dist/index.d.ts dist/index.d.cts",
+    "build": "tsup && cp dist/index.d.ts dist/index.d.cts",
     "typecheck": "tsc --noEmit",
     "clean": "rimraf dist"
   },
   "devDependencies": {
-    "@delivery-saas/shared-constants": "workspace:*",
-    "@delivery-saas/shared-types": "workspace:*",
-    "dts-bundle-generator": "^9.5.1",
     "rimraf": "^6.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0"