@back23/promptly-sdk 2.2.0 → 2.3.1

package/README.md

@@ -24,6 +24,115 @@ const { data: posts } = await client.blog.list();
 const products = await client.shop.listProducts();
 ```
 
+## v2.3.1 Changes (Bug Fix)
+
+### Dual Authentication Support Fixed
+
+API Key와 Bearer Token이 동시에 전송되도록 수정되었습니다. 이전 버전에서는 API Key가 설정되어 있으면 Authorization 헤더가 무시되어 로그인 후 멤버 전용 API 호출이 실패하는 문제가 있었습니다.
+
+```typescript
+// 이제 API Key + Bearer Token 동시 사용 가능
+const client = new Promptly({
+  tenantId: 'demo',
+  apiKey: 'pky_xxx',  // X-API-Key 헤더
+});
+
+// 로그인 후 토큰 설정
+await client.auth.login({ email, password });
+
+// 멤버 전용 API 정상 동작 (Authorization: Bearer xxx 헤더 포함)
+const profile = await client.members.getProfile();
+const orders = await client.orders.list();
+```
+
+---
+
+## v2.3.0 Changes
+
+### Polymorphic Comments API
+
+댓글 시스템이 재설계되어 게시판, 블로그, 방명록(독립 페이지) 등 다양한 곳에서 사용할 수 있습니다.
+
+```typescript
+// 게시판 글 댓글
+const boardComments = await client.comments.boardPost(postId);
+await client.comments.createBoardPost(postId, {
+  author_name: '홍길동',
+  content: '댓글 내용',
+  password: '1234', // 비회원 댓글용
+});
+
+// 블로그 글 댓글
+const blogComments = await client.comments.blogPost('post-slug');
+await client.comments.createBlogPost('post-slug', {
+  author_name: 'Jane',
+  content: 'Great post!',
+});
+
+// 방명록 (독립 페이지)
+const guestbook = await client.comments.standalone('guestbook');
+await client.comments.createStandalone('guestbook', {
+  author_name: '방문자',
+  content: '안녕하세요!',
+});
+
+// 공통 기능
+await client.comments.update(commentId, { content: '수정된 댓글' });
+await client.comments.delete(commentId, { password: '1234' });
+await client.comments.like(commentId);
+```
+
+---
+
+## v2.2.0 Changes
+
+### Entity Definition CRUD
+
+이제 API/SDK에서 직접 커스텀 엔티티 정의를 생성/수정/삭제할 수 있습니다.
+
+```typescript
+// 엔티티 정의 생성
+const entity = await client.entities.create({
+  name: '고객',
+  slug: 'customers',  // optional, auto-generated from name
+  description: '고객 관리',
+  schema: {
+    fields: [
+      { name: 'company', label: '회사명', type: 'text', required: true },
+      { name: 'email', label: '이메일', type: 'email', required: true },
+      { name: 'status', label: '상태', type: 'select', options: [
+        { value: 'active', label: '활성' },
+        { value: 'inactive', label: '비활성' }
+      ]}
+    ]
+  },
+  icon: 'users'
+});
+
+// 엔티티 정의 조회
+const entity = await client.entities.get('customers');
+
+// 엔티티 정의 수정
+await client.entities.update('customers', { name: '고객사' });
+
+// 엔티티 정의 삭제 (레코드 있으면 force 필요)
+await client.entities.delete('customers', true);
+```
+
+### Record API Path Change
+
+레코드 API 경로가 변경되었습니다:
+
+```typescript
+// v2.1.0 이전
+await client.entities.createRecord('customers', { data: { company: 'ACME' } });
+
+// v2.2.0 이후 - data wrapper 불필요
+await client.entities.createRecord('customers', { company: 'ACME' });
+```
+
+---
+
 ## v2.0.0 Breaking Changes
 
 ### API Key Required
@@ -87,14 +196,14 @@ data.map(post => ...);  // data is always an array
 
 | Resource | Read Operations | Write Operations (Auth Required) |
 |----------|-----------------|----------------------------------|
-| **Boards** | list, get, listPosts, getPost, listComments | createPost, updatePost, deletePost |
-| **Comments** | listComments | createComment, updateComment, deleteComment |
+| **Boards** | list, get, listPosts, getPost | createPost, updatePost, deletePost |
 | **Blog** | list, get, featured, byCategory, byTag | - |
+| **Comments** | boardPost, blogPost, standalone | createBoardPost, createBlogPost, createStandalone, update, delete, like |
 | **Shop** | listProducts, getProduct, listCategories | getCart, addToCart, listOrders, createOrder |
 | **Forms** | list, get, submit | mySubmissions |
 | **Auth** | login, register | logout, me, updateProfile |
 | **Media** | - | upload, list, delete |
-| **Entities** | list, getSchema, listRecords, getRecord | createRecord, updateRecord, deleteRecord |
+| **Entities** | list, get, listRecords, getRecord | create, update, delete, createRecord, updateRecord, deleteRecord |
 | **Reservation** | getSettings, listServices, listStaff, getAvailableDates, getAvailableSlots | create, list, get, cancel |
 
 ## API Reference
@@ -201,6 +310,67 @@ const tags = await client.blog.tags();
 // Returns: string[] (always an array)
 ```
 
+### Comments (댓글)
+
+3가지 댓글 유형을 지원합니다:
+- **게시판 댓글** (`board_post`)
+- **블로그 댓글** (`blog_post`)
+- **방명록/독립 댓글** (`page`)
+
+```typescript
+// 게시판 글 댓글 조회
+const { data: comments, meta } = await client.comments.boardPost(postId, {
+  page: 1,
+  per_page: 20,
+});
+// Returns: ListResponse<Comment>
+
+// 게시판 글 댓글 작성
+await client.comments.createBoardPost(postId, {
+  author_name: '홍길동',
+  author_email: 'user@example.com',
+  content: '댓글 내용',
+  password: '1234',     // 비회원용
+  parent_id: null,      // 대댓글이면 부모 댓글 ID
+  is_secret: false,     // 비밀 댓글 여부
+});
+
+// 블로그 글 댓글 조회
+const { data: blogComments } = await client.comments.blogPost('post-slug');
+// Returns: ListResponse<Comment>
+
+// 블로그 글 댓글 작성
+await client.comments.createBlogPost('post-slug', {
+  author_name: 'Jane',
+  content: 'Great post!',
+});
+
+// 방명록 댓글 조회 (page_slug로 구분)
+const { data: guestbook } = await client.comments.standalone('guestbook');
+// Returns: ListResponse<Comment>
+
+// 방명록 댓글 작성
+await client.comments.createStandalone('guestbook', {
+  author_name: '방문자',
+  content: '안녕하세요!',
+});
+
+// 댓글 수정
+await client.comments.update(commentId, {
+  content: '수정된 댓글',
+  password: '1234', // 비회원이 작성한 댓글인 경우
+});
+
+// 댓글 삭제
+await client.comments.delete(commentId, {
+  password: '1234', // 비회원이 작성한 댓글인 경우
+});
+
+// 댓글 좋아요
+const result = await client.comments.like(commentId);
+// Returns: { data: { likes: number } }
+```
+
 ### Shop (쇼핑)
 
 #### Public (로그인 불필요)
@@ -477,60 +647,84 @@ const { data: mediaList, meta } = await client.media.list({
 await client.media.delete(mediaId);
 ```
 
-### Entities (커스텀 엔티티) - AI가 생성한 동적 데이터
+### Entities (커스텀 엔티티) - 동적 데이터 구조
 
-AI가 MCP를 통해 생성한 커스텀 데이터 구조에 접근합니다.
+API/SDK에서 직접 엔티티 정의를 생성하고 데이터를 관리할 수 있습니다.
 
-#### Public
+#### Entity Definition CRUD
 
 ```typescript
 // 엔티티 목록 조회
 const entities = await client.entities.list();
 // Returns: CustomEntity[] (always an array)
 
-// 엔티티 스키마 조회
-const schema = await client.entities.getSchema('customer');
-// Returns: EntitySchema
+// 엔티티 정의 생성
+const entity = await client.entities.create({
+  name: '고객',
+  slug: 'customers',
+  description: '고객 관리',
+  schema: {
+    fields: [
+      { name: 'company', label: '회사명', type: 'text', required: true },
+      { name: 'email', label: '이메일', type: 'email', required: true },
+      { name: 'status', label: '상태', type: 'select', options: [
+        { value: 'active', label: '활성' },
+        { value: 'inactive', label: '비활성' }
+      ]}
+    ]
+  },
+  icon: 'users'
+});
+
+// 엔티티 정의 조회 (스키마 포함)
+const entity = await client.entities.get('customers');
+// Returns: CustomEntity (includes schema)
+
+// 엔티티 정의 수정
+await client.entities.update('customers', {
+  name: '고객사',
+  description: '고객사 관리'
+});
+
+// 엔티티 정의 삭제 (레코드가 있으면 force 필요)
+await client.entities.delete('customers');        // 레코드 없을 때
+await client.entities.delete('customers', true);  // 레코드 있어도 강제 삭제
+```
+
+#### Record CRUD
 
+```typescript
 // 레코드 목록 조회
-const { data: customers, meta } = await client.entities.listRecords('customer', {
+const { data: customers, meta } = await client.entities.listRecords('customers', {
   page: 1,
   per_page: 20,
-  status: 'active',
+  search: 'ACME',              // 검색
+  sort: 'company',             // 정렬 필드
+  dir: 'asc',                  // 정렬 방향
+  filters: JSON.stringify({ status: 'active' })  // JSON 필터
 });
 // Returns: ListResponse<EntityRecord>
 
-// 데이터 필드로 필터링
-const { data: vipCustomers } = await client.entities.listRecords('customer', {
-  'data.tier': 'vip',
-});
-
 // 단일 레코드 조회
-const customer = await client.entities.getRecord('customer', 1);
+const customer = await client.entities.getRecord('customers', 1);
 // Returns: EntityRecord
 console.log(customer.data.company); // 'ABC Corp'
-```
-
-#### Protected (로그인 필요)
 
-```typescript
-// 레코드 생성
-const newCustomer = await client.entities.createRecord('customer', {
-  data: {
-    company: 'ABC Corp',
-    email: 'contact@abc.com',
-    tier: 'standard',
-  },
+// 레코드 생성 (스키마 필드 직접 전달)
+const newCustomer = await client.entities.createRecord('customers', {
+  company: 'ABC Corp',
+  email: 'contact@abc.com',
   status: 'active',
 });
 
-// 레코드 수정
-await client.entities.updateRecord('customer', 1, {
-  data: { tier: 'vip' },
+// 레코드 수정 (부분 업데이트 - 기존 데이터와 병합)
+await client.entities.updateRecord('customers', 1, {
+  status: 'inactive',
+  email: 'new@abc.com'
 });
 
 // 레코드 삭제
-await client.entities.deleteRecord('customer', 1);
+await client.entities.deleteRecord('customers', 1);
 ```
 
 #### TypeScript 타입 지원
@@ -651,6 +845,21 @@ interface BlogPost {
   created_at: string;
 }
 
+interface Comment {
+  id: number;
+  type: 'board_post' | 'blog_post' | 'page';
+  author_name: string;
+  author_avatar: string | null;
+  content: string;
+  is_approved: boolean;
+  is_pinned: boolean;
+  is_secret: boolean;
+  likes: number;
+  depth: number;
+  created_at: string;
+  replies: Comment[];
+}
+
 interface Product {
   id: number;
   slug: string;

package/dist/index.d.mts

@@ -237,6 +237,42 @@ interface BlogListParams extends ListParams {
     search?: string;
 }
 
+type CommentType = 'board_post' | 'blog_post' | 'page';
+interface Comment {
+    id: number;
+    type: CommentType;
+    author_name: string;
+    author_avatar: string | null;
+    content: string;
+    is_approved: boolean;
+    is_pinned: boolean;
+    is_secret: boolean;
+    likes: number;
+    depth: number;
+    created_at: string;
+    replies: Comment[];
+}
+interface CommentListResponse extends ListResponse<Comment> {
+}
+interface CommentListParams extends ListParams {
+    include_unapproved?: boolean;
+}
+interface CommentCreateData {
+    author_name?: string;
+    author_email?: string;
+    content: string;
+    password?: string;
+    parent_id?: number | null;
+    is_secret?: boolean;
+}
+interface CommentUpdateData {
+    content: string;
+    password?: string;
+}
+interface CommentDeleteData {
+    password?: string;
+}
+
 /**
  * Form types for Promptly SDK
  */
@@ -793,7 +829,7 @@ declare class HttpClient {
     private buildUrl;
     /**
      * Build request headers
-     * API key takes precedence over bearer token for server-to-server auth
+     * Both API key and bearer token can be sent together
      */
     private buildHeaders;
     /**
@@ -1004,6 +1040,49 @@ declare class BlogResource {
     tags(): Promise<string[]>;
 }
 
+declare class CommentsResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get comments for a board post
+     */
+    boardPost(postId: number, params?: CommentListParams): Promise<CommentListResponse>;
+    /**
+     * Create a comment on a board post
+     */
+    createBoardPost(postId: number, data: CommentCreateData): Promise<ApiResponse<Comment>>;
+    /**
+     * Get comments for a blog post
+     */
+    blogPost(slug: string, params?: CommentListParams): Promise<CommentListResponse>;
+    /**
+     * Create a comment on a blog post
+     */
+    createBlogPost(slug: string, data: CommentCreateData): Promise<ApiResponse<Comment>>;
+    /**
+     * Get standalone comments (guestbook, feedback, etc.)
+     */
+    standalone(pageSlug: string, params?: CommentListParams): Promise<CommentListResponse>;
+    /**
+     * Create a standalone comment
+     */
+    createStandalone(pageSlug: string, data: CommentCreateData): Promise<ApiResponse<Comment>>;
+    /**
+     * Update a comment
+     */
+    update(commentId: number, data: CommentUpdateData): Promise<ApiResponse<Comment>>;
+    /**
+     * Delete a comment
+     */
+    delete(commentId: number, data?: CommentDeleteData): Promise<ApiResponse<void>>;
+    /**
+     * Like a comment
+     */
+    like(commentId: number): Promise<ApiResponse<{
+        likes: number;
+    }>>;
+}
+
 /**
  * Form Resource for Promptly SDK
  */
@@ -1461,10 +1540,12 @@ declare class Promptly {
     private http;
     /** Authentication & user management */
     readonly auth: AuthResource;
-    /** Board posts and comments */
+    /** Board posts */
     readonly boards: BoardsResource;
     /** Blog posts */
     readonly blog: BlogResource;
+    /** Comments for boards, blogs, and standalone pages */
+    readonly comments: CommentsResource;
     /** Forms and submissions */
     readonly forms: FormsResource;
     /** E-commerce: products, cart, orders, payments */
@@ -1522,4 +1603,4 @@ declare class Promptly {
     getApiKey(): string | null;
 }
 
-export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type BoardSettings, type Cart, type CartItem, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };
+export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type BoardSettings, type Cart, type CartItem, type Comment, type CommentCreateData, type CommentDeleteData, type CommentListParams, type CommentListResponse, type CommentType, type CommentUpdateData, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };

package/dist/index.d.ts

@@ -237,6 +237,42 @@ interface BlogListParams extends ListParams {
     search?: string;
 }
 
+type CommentType = 'board_post' | 'blog_post' | 'page';
+interface Comment {
+    id: number;
+    type: CommentType;
+    author_name: string;
+    author_avatar: string | null;
+    content: string;
+    is_approved: boolean;
+    is_pinned: boolean;
+    is_secret: boolean;
+    likes: number;
+    depth: number;
+    created_at: string;
+    replies: Comment[];
+}
+interface CommentListResponse extends ListResponse<Comment> {
+}
+interface CommentListParams extends ListParams {
+    include_unapproved?: boolean;
+}
+interface CommentCreateData {
+    author_name?: string;
+    author_email?: string;
+    content: string;
+    password?: string;
+    parent_id?: number | null;
+    is_secret?: boolean;
+}
+interface CommentUpdateData {
+    content: string;
+    password?: string;
+}
+interface CommentDeleteData {
+    password?: string;
+}
+
 /**
  * Form types for Promptly SDK
  */
@@ -793,7 +829,7 @@ declare class HttpClient {
     private buildUrl;
     /**
      * Build request headers
-     * API key takes precedence over bearer token for server-to-server auth
+     * Both API key and bearer token can be sent together
      */
     private buildHeaders;
     /**
@@ -1004,6 +1040,49 @@ declare class BlogResource {
     tags(): Promise<string[]>;
 }
 
+declare class CommentsResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get comments for a board post
+     */
+    boardPost(postId: number, params?: CommentListParams): Promise<CommentListResponse>;
+    /**
+     * Create a comment on a board post
+     */
+    createBoardPost(postId: number, data: CommentCreateData): Promise<ApiResponse<Comment>>;
+    /**
+     * Get comments for a blog post
+     */
+    blogPost(slug: string, params?: CommentListParams): Promise<CommentListResponse>;
+    /**
+     * Create a comment on a blog post
+     */
+    createBlogPost(slug: string, data: CommentCreateData): Promise<ApiResponse<Comment>>;
+    /**
+     * Get standalone comments (guestbook, feedback, etc.)
+     */
+    standalone(pageSlug: string, params?: CommentListParams): Promise<CommentListResponse>;
+    /**
+     * Create a standalone comment
+     */
+    createStandalone(pageSlug: string, data: CommentCreateData): Promise<ApiResponse<Comment>>;
+    /**
+     * Update a comment
+     */
+    update(commentId: number, data: CommentUpdateData): Promise<ApiResponse<Comment>>;
+    /**
+     * Delete a comment
+     */
+    delete(commentId: number, data?: CommentDeleteData): Promise<ApiResponse<void>>;
+    /**
+     * Like a comment
+     */
+    like(commentId: number): Promise<ApiResponse<{
+        likes: number;
+    }>>;
+}
+
 /**
  * Form Resource for Promptly SDK
  */
@@ -1461,10 +1540,12 @@ declare class Promptly {
     private http;
     /** Authentication & user management */
     readonly auth: AuthResource;
-    /** Board posts and comments */
+    /** Board posts */
     readonly boards: BoardsResource;
     /** Blog posts */
     readonly blog: BlogResource;
+    /** Comments for boards, blogs, and standalone pages */
+    readonly comments: CommentsResource;
     /** Forms and submissions */
     readonly forms: FormsResource;
     /** E-commerce: products, cart, orders, payments */
@@ -1522,4 +1603,4 @@ declare class Promptly {
     getApiKey(): string | null;
 }
 
-export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type BoardSettings, type Cart, type CartItem, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };
+export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type BoardSettings, type Cart, type CartItem, type Comment, type CommentCreateData, type CommentDeleteData, type CommentListParams, type CommentListResponse, type CommentType, type CommentUpdateData, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };

package/dist/index.js

@@ -122,7 +122,7 @@ var HttpClient = class {
   }
   /**
    * Build request headers
-   * API key takes precedence over bearer token for server-to-server auth
+   * Both API key and bearer token can be sent together
    */
   buildHeaders(customHeaders) {
     const headers = {
@@ -132,7 +132,8 @@ var HttpClient = class {
     };
     if (this.apiKey) {
       headers["X-API-Key"] = this.apiKey;
-    } else if (this.token) {
+    }
+    if (this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
     }
     return headers;
@@ -227,7 +228,8 @@ var HttpClient = class {
     };
     if (this.apiKey) {
       headers["X-API-Key"] = this.apiKey;
-    } else if (this.token) {
+    }
+    if (this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
     }
     const controller = new AbortController();
@@ -538,6 +540,67 @@ var BlogResource = class {
   }
 };
 
+// src/resources/comments.ts
+var CommentsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get comments for a board post
+   */
+  async boardPost(postId, params) {
+    return this.http.get(`/posts/${postId}/comments`, params);
+  }
+  /**
+   * Create a comment on a board post
+   */
+  async createBoardPost(postId, data) {
+    return this.http.post(`/posts/${postId}/comments`, data);
+  }
+  /**
+   * Get comments for a blog post
+   */
+  async blogPost(slug, params) {
+    return this.http.get(`/blog/${slug}/comments`, params);
+  }
+  /**
+   * Create a comment on a blog post
+   */
+  async createBlogPost(slug, data) {
+    return this.http.post(`/blog/${slug}/comments`, data);
+  }
+  /**
+   * Get standalone comments (guestbook, feedback, etc.)
+   */
+  async standalone(pageSlug, params) {
+    return this.http.get(`/comments/${pageSlug}`, params);
+  }
+  /**
+   * Create a standalone comment
+   */
+  async createStandalone(pageSlug, data) {
+    return this.http.post(`/comments/${pageSlug}`, data);
+  }
+  /**
+   * Update a comment
+   */
+  async update(commentId, data) {
+    return this.http.put(`/comments/${commentId}`, data);
+  }
+  /**
+   * Delete a comment
+   */
+  async delete(commentId, data) {
+    return this.http.delete(`/comments/${commentId}`, data);
+  }
+  /**
+   * Like a comment
+   */
+  async like(commentId) {
+    return this.http.post(`/comments/${commentId}/like`);
+  }
+};
+
 // src/resources/forms.ts
 var FormsResource = class {
   constructor(http) {
@@ -1153,6 +1216,7 @@ var Promptly = class {
     this.auth = new AuthResource(this.http);
     this.boards = new BoardsResource(this.http);
     this.blog = new BlogResource(this.http);
+    this.comments = new CommentsResource(this.http);
     this.forms = new FormsResource(this.http);
     this.shop = new ShopResource(this.http);
     this.media = new MediaResource(this.http);

package/dist/index.mjs

@@ -94,7 +94,7 @@ var HttpClient = class {
   }
   /**
    * Build request headers
-   * API key takes precedence over bearer token for server-to-server auth
+   * Both API key and bearer token can be sent together
    */
   buildHeaders(customHeaders) {
     const headers = {
@@ -104,7 +104,8 @@ var HttpClient = class {
     };
     if (this.apiKey) {
       headers["X-API-Key"] = this.apiKey;
-    } else if (this.token) {
+    }
+    if (this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
     }
     return headers;
@@ -199,7 +200,8 @@ var HttpClient = class {
     };
     if (this.apiKey) {
       headers["X-API-Key"] = this.apiKey;
-    } else if (this.token) {
+    }
+    if (this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
     }
     const controller = new AbortController();
@@ -510,6 +512,67 @@ var BlogResource = class {
   }
 };
 
+// src/resources/comments.ts
+var CommentsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get comments for a board post
+   */
+  async boardPost(postId, params) {
+    return this.http.get(`/posts/${postId}/comments`, params);
+  }
+  /**
+   * Create a comment on a board post
+   */
+  async createBoardPost(postId, data) {
+    return this.http.post(`/posts/${postId}/comments`, data);
+  }
+  /**
+   * Get comments for a blog post
+   */
+  async blogPost(slug, params) {
+    return this.http.get(`/blog/${slug}/comments`, params);
+  }
+  /**
+   * Create a comment on a blog post
+   */
+  async createBlogPost(slug, data) {
+    return this.http.post(`/blog/${slug}/comments`, data);
+  }
+  /**
+   * Get standalone comments (guestbook, feedback, etc.)
+   */
+  async standalone(pageSlug, params) {
+    return this.http.get(`/comments/${pageSlug}`, params);
+  }
+  /**
+   * Create a standalone comment
+   */
+  async createStandalone(pageSlug, data) {
+    return this.http.post(`/comments/${pageSlug}`, data);
+  }
+  /**
+   * Update a comment
+   */
+  async update(commentId, data) {
+    return this.http.put(`/comments/${commentId}`, data);
+  }
+  /**
+   * Delete a comment
+   */
+  async delete(commentId, data) {
+    return this.http.delete(`/comments/${commentId}`, data);
+  }
+  /**
+   * Like a comment
+   */
+  async like(commentId) {
+    return this.http.post(`/comments/${commentId}/like`);
+  }
+};
+
 // src/resources/forms.ts
 var FormsResource = class {
   constructor(http) {
@@ -1125,6 +1188,7 @@ var Promptly = class {
     this.auth = new AuthResource(this.http);
     this.boards = new BoardsResource(this.http);
     this.blog = new BlogResource(this.http);
+    this.comments = new CommentsResource(this.http);
     this.forms = new FormsResource(this.http);
     this.shop = new ShopResource(this.http);
     this.media = new MediaResource(this.http);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@back23/promptly-sdk",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "Promptly AI CMS SDK for JavaScript/TypeScript",
   "main": "dist/index.js",
   "module": "dist/index.mjs",