@back23/promptly-sdk 2.12.0 → 2.13.0

package/README.md

@@ -1,6 +1,6 @@
 # @back23/promptly-sdk
 
-Promptly AI CMS SDK for JavaScript/TypeScript
+Official SDK for Promptly AI CMS - A headless CMS with built-in AI capabilities.
 
 ## Installation
 
@@ -14,666 +14,234 @@ npm install @back23/promptly-sdk
 import { Promptly } from '@back23/promptly-sdk';
 
 const client = new Promptly({
-  tenantId: 'demo',
-  apiKey: 'pky_your_api_key_here',  // Required - Get from Dashboard > Settings > API Tokens
+  tenantId: 'your-tenant-id',
+  apiKey: 'pky_xxxxxxxxxxxxxxxx', // Required - Get from Dashboard > Settings > API Tokens
   baseUrl: 'https://promptly.webbyon.com', // Optional
 });
 
-// All API calls require API key
-const { data: posts } = await client.blog.list();
-const products = await client.shop.listProducts();
-```
-
-## v2.11.0 Changes
-
-### Blog API Enhancement
-
-Added missing fields to blog post responses and new endpoints for categories/tags.
-
-**New API Endpoints:**
-- `GET /api/{tenant}/blog/categories` - List all blog categories
-- `GET /api/{tenant}/blog/tags` - List all blog tags
-
-**BlogPost Type Updated:**
-```typescript
-interface BlogPost {
-  id: number;
-  title: string;
-  slug: string;
-  excerpt: string;
-  featured_image: string | null;
-  category: string | null;      // NEW
-  tags: string[];               // NEW
-  author: string;
-  views: number;                // NEW
-  status: string;
-  published_at: string | null;  // NEW
-  created_at: string;
-  content?: string;             // Detail only
-  updated_at?: string;          // Detail only
-}
-```
-
-**SDK Usage:**
-```typescript
-// Get all categories
-const categories = await client.blog.categories();
-// Returns: string[]
-
-// Get all tags
-const tags = await client.blog.tags();
-// Returns: string[]
-
-// Filter by category
-const { data: posts } = await client.blog.byCategory('tech');
-
-// Filter by tag
-const { data: posts } = await client.blog.byTag('laravel');
-
-// Access new fields
-const { data: posts } = await client.blog.list();
-posts.forEach(post => {
-  console.log(post.category);     // 'tech' | null
-  console.log(post.tags);         // ['laravel', 'php']
-  console.log(post.views);        // 1234
-  console.log(post.published_at); // '2026-01-06T12:00:00+00:00'
-});
-```
-
----
-
-## v2.5.0 Changes
-
-### BoardPost Type Extension
+// Fetch blog posts
+const { data: posts, meta } = await client.blog.list();
 
-Added `is_secret` and `is_mine` fields to posts.
-
-```typescript
-interface BoardPost {
-  // ... existing fields
-  is_notice: boolean;  // Whether it's a notice
-  is_secret: boolean;  // Whether it's a secret post
-  is_mine: boolean;    // Whether current logged-in user is the author
-}
+// Fetch products
+const { data: products } = await client.shop.listProducts();
 ```
 
----
+## Authentication
 
-## v2.3.1 Changes (Bug Fix)
-
-### Dual Authentication Support Fixed
-
-Fixed issue where API Key and Bearer Token are now sent simultaneously. In previous versions, when API Key was set, the Authorization header was ignored, causing member-only API calls to fail after login.
+All API requests require an API key. Get yours from **Dashboard > Settings > API Tokens**.
 
 ```typescript
-// API Key + Bearer Token now work together
 const client = new Promptly({
   tenantId: 'demo',
-  apiKey: 'pky_xxx',  // X-API-Key header
+  apiKey: 'pky_xxxxxxxxxxxxxxxx', // Required
 });
-
-// Set token after login
-await client.auth.login({ email, password });
-
-// Member-only APIs work correctly (Authorization: Bearer xxx header included)
-const profile = await client.members.getProfile();
-const orders = await client.orders.list();
 ```
 
----
-
-## v2.3.0 Changes
-
-### Polymorphic Comments API
-
-The comment system has been redesigned to support various use cases including boards, blogs, and guestbooks (standalone pages).
+For member-specific operations (orders, profile, etc.), authenticate first:
 
 ```typescript
-// Board post comments
-const boardComments = await client.comments.boardPost(postId);
-await client.comments.createBoardPost(postId, {
-  author_name: 'John Doe',
-  content: 'Comment content',
-  password: '1234', // For guest comments
-});
+// Login
+await client.auth.login({ email: 'user@example.com', password: 'password' });
 
-// Blog post comments
-const blogComments = await client.comments.blogPost('post-slug');
-await client.comments.createBlogPost('post-slug', {
-  author_name: 'Jane',
-  content: 'Great post!',
-});
+// Now member-only APIs work
+const profile = await client.members.getProfile();
+const orders = await client.orders.list();
 
-// Guestbook (standalone page)
-const guestbook = await client.comments.standalone('guestbook');
-await client.comments.createStandalone('guestbook', {
-  author_name: 'Visitor',
-  content: 'Hello!',
-});
+// Check auth status
+client.isAuthenticated(); // true
 
-// Common features
-await client.comments.update(commentId, { content: 'Updated comment' });
-await client.comments.delete(commentId, { password: '1234' });
-await client.comments.like(commentId);
+// Logout
+await client.auth.logout();
 ```
 
----
-
-## v2.2.0 Changes
-
-### Entity Definition CRUD
+## API Reference
 
-You can now create/update/delete custom entity definitions directly from the API/SDK.
+### Blog
 
 ```typescript
-// Create entity definition
-const entity = await client.entities.create({
-  name: 'Customer',
-  slug: 'customers',  // optional, auto-generated from name
-  description: 'Customer management',
-  schema: {
-    fields: [
-      { name: 'company', label: 'Company Name', type: 'text', required: true },
-      { name: 'email', label: 'Email', type: 'email', required: true },
-      { name: 'status', label: 'Status', type: 'select', options: [
-        { value: 'active', label: 'Active' },
-        { value: 'inactive', label: 'Inactive' }
-      ]}
-    ]
-  },
-  icon: 'users'
+// List posts
+const { data, meta } = await client.blog.list({
+  page: 1,
+  per_page: 10,
+  category: 'tech',    // Optional filter
+  tag: 'laravel',      // Optional filter
+  search: 'keyword',   // Optional search
 });
 
-// Get entity definition
-const entity = await client.entities.get('customers');
-
-// Update entity definition
-await client.entities.update('customers', { name: 'Clients' });
-
-// Delete entity definition (requires force if records exist)
-await client.entities.delete('customers', true);
-```
-
-### Record API Path Change
-
-The record API path has changed:
-
-```typescript
-// Before v2.1.0
-await client.entities.createRecord('customers', { data: { company: 'ACME' } });
-
-// v2.2.0 and later - no data wrapper needed
-await client.entities.createRecord('customers', { company: 'ACME' });
-```
-
----
-
-## v2.0.0 Breaking Changes
+// Get single post
+const post = await client.blog.get('post-slug');
 
-### API Key Required
+// Get featured posts
+const featured = await client.blog.featured(5);
 
-**All API requests now require an API key.** There are no public APIs - this ensures security and proper tenant isolation.
+// Filter by category/tag
+const { data } = await client.blog.byCategory('news');
+const { data } = await client.blog.byTag('featured');
 
-```typescript
-// ❌ v1.x - apiKey was optional
-const client = new Promptly({
-  tenantId: 'demo',
-});
-
-// ✅ v2.0 - apiKey is REQUIRED
-const client = new Promptly({
-  tenantId: 'demo',
-  apiKey: 'pky_xxxxxxxxxxxxxxxxxxxxxxxx',
-});
+// Get all categories and tags
+const categories = await client.blog.categories(); // string[]
+const tags = await client.blog.tags();             // string[]
 ```
 
-Get your API key from: **Dashboard > Settings > API Tokens**
-
-The SDK automatically includes the `X-API-Key` header in all requests.
-
----
-
-## v1.3.0 Changes
-
-### Unified Response Structure
-
-All list APIs now return a consistent `ListResponse<T>` format:
-
+**BlogPost Type:**
 ```typescript
-interface ListResponse<T> {
-  data: T[];  // Always an array (never null/undefined)
-  meta: {
-    current_page: number;
-    last_page: number;
-    per_page: number;
-    total: number;
-    from: number | null;
-    to: number | null;
-  };
+interface BlogPost {
+  id: number;
+  title: string;
+  slug: string;
+  excerpt: string;
+  featured_image: string | null;
+  category: string | null;
+  tags: string[];
+  author: string;
+  views: number;
+  status: string;
+  published_at: string | null;
+  created_at: string;
+  content?: string;      // Detail view only
+  updated_at?: string;   // Detail view only
 }
 ```
 
-**No more defensive code needed:**
-
-```typescript
-// Before (v1.1.0)
-const posts = await client.blog.list();
-const items = posts?.data ?? [];  // Defensive check needed
-
-// After (v1.3.0)
-const { data, meta } = await client.blog.list();
-data.map(post => ...);  // data is always an array
-```
-
-## API Overview
-
-> **Note:** All APIs require API key (v2.0+). "Auth Required" means additional member login token is needed.
-
-| Resource | Read Operations | Write Operations (Auth Required) |
-|----------|-----------------|----------------------------------|
-| **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, get, listRecords, getRecord | create, update, delete, createRecord, updateRecord, deleteRecord |
-| **Reservation** | getSettings, listServices, listStaff, getAvailableDates, getAvailableSlots | create, list, get, cancel |
-
-## API Reference
-
 ### Boards
 
 ```typescript
 // List boards
-const { data: boards, meta } = await client.boards.list();
-// Returns: ListResponse<Board>
+const { data: boards } = await client.boards.list();
 
-// Get board details
-const board = await client.boards.get('first'); // slug or id
-// Returns: Board
+// Get board
+const board = await client.boards.get('board-slug');
 
-// List board posts
-const { data: posts, meta } = await client.boards.listPosts('first', {
+// List posts
+const { data: posts } = await client.boards.listPosts('board-slug', {
   page: 1,
   per_page: 10,
-  search: 'keyword', // optional
+  search: 'keyword',
 });
-// Returns: ListResponse<BoardPost>
-
-// Get post details
-const post = await client.boards.getPost(1);
-// Returns: BoardPost
 
-// List comments
-const comments = await client.boards.listComments(1);
-// Returns: BoardComment[] (always an array)
-```
-
-### Posts & Comments - Protected (Login Required)
+// Get post
+const post = await client.boards.getPost(postId);
 
-```typescript
-// Login first
-await client.auth.login({ email: 'user@example.com', password: 'password' });
-
-// Create post
-const newPost = await client.boards.createPost({
+// Create post (auth required)
+await client.boards.createPost({
   board_id: 1,
   title: 'Title',
   content: 'Content',
-  is_notice: false,
 });
 
-// Update post
-await client.boards.updatePost(postId, {
-  title: 'Updated title',
-  content: 'Updated content',
-});
-
-// Delete post
+// Update/Delete post (auth required)
+await client.boards.updatePost(postId, { title: 'New Title' });
 await client.boards.deletePost(postId);
-
-// Create comment
-await client.boards.createComment(postId, {
-  content: 'Comment content',
-  parent_id: null, // Parent comment ID for replies
-});
-
-// Update comment
-await client.boards.updateComment(commentId, {
-  content: 'Updated comment',
-});
-
-// Delete comment
-await client.boards.deleteComment(commentId);
-```
-
-### Blog
-
-```typescript
-// List blog posts
-const { data: posts, meta } = await client.blog.list({
-  page: 1,
-  per_page: 10,
-  category: 'news', // optional
-  tag: 'featured',  // optional
-  search: 'keyword', // optional
-});
-// Returns: ListResponse<BlogPost>
-
-// Get blog post details
-const post = await client.blog.get('post-slug');
-// Returns: BlogPost
-
-// Featured posts
-const featured = await client.blog.featured(5);
-// Returns: BlogPost[] (always an array)
-
-// Get posts by category
-const { data: newsPosts } = await client.blog.byCategory('news');
-
-// Get posts by tag
-const { data: taggedPosts } = await client.blog.byTag('featured');
-
-// List categories
-const categories = await client.blog.categories();
-// Returns: string[] (always an array)
-
-// List tags
-const tags = await client.blog.tags();
-// Returns: string[] (always an array)
 ```
 
 ### Comments
 
-Three comment types are supported:
-- **Board comments** (`board_post`)
-- **Blog comments** (`blog_post`)
-- **Guestbook/Standalone comments** (`page`)
+Supports three comment types: board posts, blog posts, and standalone pages (guestbook).
 
 ```typescript
-// Get board post comments
-const { data: comments, meta } = await client.comments.boardPost(postId, {
-  page: 1,
-  per_page: 20,
-});
-// Returns: ListResponse<Comment>
-
-// Create board post comment
+// Board post comments
+const { data } = await client.comments.boardPost(postId);
 await client.comments.createBoardPost(postId, {
-  author_name: 'John Doe',
-  author_email: 'user@example.com',
-  content: 'Comment content',
-  password: '1234',     // For guest comments
-  parent_id: null,      // Parent comment ID for replies
-  is_secret: false,     // Secret comment flag
+  author_name: 'John',
+  content: 'Great post!',
+  password: '1234',  // For guest comments
 });
 
-// Get blog post comments
-const { data: blogComments } = await client.comments.blogPost('post-slug');
-// Returns: ListResponse<Comment>
-
-// Create blog post comment
+// Blog post comments
+const { data } = await client.comments.blogPost('post-slug');
 await client.comments.createBlogPost('post-slug', {
   author_name: 'Jane',
-  content: 'Great post!',
+  content: 'Nice article!',
 });
 
-// Get guestbook comments (identified by page_slug)
-const { data: guestbook } = await client.comments.standalone('guestbook');
-// Returns: ListResponse<Comment>
-
-// Create guestbook comment
+// Standalone comments (guestbook)
+const { data } = await client.comments.standalone('guestbook');
 await client.comments.createStandalone('guestbook', {
   author_name: 'Visitor',
   content: 'Hello!',
 });
 
-// Update comment
-await client.comments.update(commentId, {
-  content: 'Updated comment',
-  password: '1234', // Required for guest comments
-});
-
-// Delete comment
-await client.comments.delete(commentId, {
-  password: '1234', // Required for guest comments
-});
-
-// Like comment
-const result = await client.comments.like(commentId);
-// Returns: { data: { likes: number } }
+// Common operations
+await client.comments.update(commentId, { content: 'Updated' });
+await client.comments.delete(commentId, { password: '1234' });
+await client.comments.like(commentId);
 ```
 
 ### Shop
 
-#### Public (No Login Required)
-
 ```typescript
-// List products
-const { data: products, meta } = await client.shop.listProducts({
-  page: 1,
-  per_page: 10,
-  category: 'electronics', // optional
-  is_featured: true,       // optional
-  search: 'keyword',       // optional
+// Products
+const { data: products } = await client.shop.listProducts({
+  category: 'electronics',
+  is_featured: true,
 });
-// Returns: ListResponse<Product>
-
-// Get product details
 const product = await client.shop.getProduct('product-slug');
-// Returns: Product
-
-// Featured products
 const featured = await client.shop.featuredProducts(8);
-// Returns: Product[] (always an array)
-
-// List categories
 const categories = await client.shop.listCategories();
-// Returns: ProductCategory[] (always an array)
-```
-
-#### Protected (Login Required)
 
-```typescript
-// Get cart
+// Cart (auth required)
 const cart = await client.shop.getCart();
-// Returns: Cart
-
-// Add to cart
-await client.shop.addToCart({
-  product_id: 1,
-  quantity: 2,
-  variant_id: 10, // optional - for variant products
-});
-
-// Update cart item quantity
+await client.shop.addToCart({ product_id: 1, quantity: 2 });
 await client.shop.updateCartItem(itemId, { quantity: 3 });
-
-// Remove from cart
 await client.shop.removeFromCart(itemId);
-
-// Clear cart
 await client.shop.clearCart();
 
-// Create order
+// Orders (auth required)
 const order = await client.shop.createOrder({
   orderer_name: 'John Doe',
   orderer_email: 'john@example.com',
-  orderer_phone: '555-123-4567',
+  orderer_phone: '555-1234',
   shipping_name: 'John Doe',
-  shipping_phone: '555-123-4567',
+  shipping_phone: '555-1234',
   shipping_zipcode: '12345',
   shipping_address: '123 Main St',
   shipping_address_detail: 'Apt 101',
-  shipping_memo: 'Leave at door',
-  coupon_code: 'SAVE10', // optional
 });
-
-// List orders
-const { data: orders, meta } = await client.shop.listOrders();
-// Returns: ListResponse<Order>
-
-// Get order details
-const order = await client.shop.getOrder(orderId);
-// Returns: Order
-
-// Cancel order
+const { data: orders } = await client.shop.listOrders();
+const orderDetail = await client.shop.getOrder(orderId);
 await client.shop.cancelOrder(orderId);
 
-// Validate coupon
+// Coupons
 const validation = await client.shop.validateCoupon('SAVE10', 50000);
-// Returns: { valid: boolean, discount_amount: number, coupon: Coupon }
-
-// My coupons
-const coupons = await client.shop.myCoupons();
-// Returns: Coupon[] (always an array)
+const myCoupons = await client.shop.myCoupons();
 ```
 
-### Reservation - NEW in v1.3.0
-
-#### Public (No Login Required)
+### Reservation
 
 ```typescript
-// Get reservation settings
+// Public APIs
 const settings = await client.reservation.getSettings();
-// Returns: ReservationSettings
-
-// List services
 const services = await client.reservation.listServices();
-// Returns: ReservationService[] (always an array)
+const staff = await client.reservation.listStaff(serviceId);
 
-// List staff
-const staffs = await client.reservation.listStaff();
-// Returns: ReservationStaff[] (always an array)
-
-// Get staff for specific service
-const serviceStaffs = await client.reservation.listStaff(serviceId);
-
-// Get available dates
+// Get available dates/slots
 const dates = await client.reservation.getAvailableDates({
   service_id: 1,
-  staff_id: 2,        // optional
-  start_date: '2026-01-01', // optional
-  end_date: '2026-01-31',   // optional
+  staff_id: 2,
+  start_date: '2026-01-01',
+  end_date: '2026-01-31',
 });
-// Returns: string[] (YYYY-MM-DD format)
-
-// Get available time slots
 const slots = await client.reservation.getAvailableSlots({
   service_id: 1,
   date: '2026-01-15',
-  staff_id: 2, // optional
+  staff_id: 2,
 });
-// Returns: ReservationSlot[]
-```
-
-#### Protected (Login Required)
 
-```typescript
-// Create reservation
+// Create reservation (auth required)
 const result = await client.reservation.create({
   service_id: 1,
-  staff_id: 2, // optional
+  staff_id: 2,
   reservation_date: '2026-01-15',
   start_time: '14:00',
   customer_name: 'John Doe',
-  customer_phone: '555-123-4567', // optional
-  customer_email: 'john@example.com', // optional
-  customer_memo: 'Special requests', // optional
+  customer_phone: '555-1234',
 });
-// Returns: { reservation: Reservation, requires_payment: boolean, deposit: number }
 
-// List my reservations
-const { data: reservations, meta } = await client.reservation.list({
-  status: 'confirmed', // optional
-  upcoming: true,      // optional
-  past: false,         // optional
-});
-// Returns: ListResponse<Reservation>
-
-// Upcoming reservations
+// My reservations (auth required)
+const { data } = await client.reservation.list({ status: 'confirmed' });
 const upcoming = await client.reservation.upcoming(5);
-// Returns: Reservation[] (always an array)
-
-// Past reservations
 const past = await client.reservation.past(10);
-// Returns: Reservation[] (always an array)
-
-// Get reservation details
-const reservation = await client.reservation.get('RES-20260115-001');
-// Returns: Reservation
-
-// Cancel reservation
-const cancelled = await client.reservation.cancel('RES-20260115-001', 'Schedule change');
-// Returns: Reservation
-```
-
-### Auth (Authentication)
-
-```typescript
-// Login
-const response = await client.auth.login({
-  email: 'user@example.com',
-  password: 'password',
-});
-// Returns: { member: Member, token: string }
-// Token is automatically stored
-
-// Register
-await client.auth.register({
-  name: 'John Doe',
-  email: 'user@example.com',
-  password: 'password',
-  password_confirmation: 'password',
-  phone: '555-123-4567', // optional
-});
-
-// Logout
-await client.auth.logout();
-
-// Get current user
-const me = await client.auth.me();
-// Returns: Member
-
-// Update profile
-await client.auth.updateProfile({
-  name: 'New Name',
-  phone: '555-999-8888',
-});
-
-// Change password
-await client.auth.updateProfile({
-  current_password: 'current_password',
-  password: 'new_password',
-  password_confirmation: 'new_password',
-});
-
-// Check authentication status
-client.isAuthenticated(); // true or false
-
-// Set token directly (e.g., from localStorage)
-client.setToken('saved-token');
-
-// Get token
-const token = client.getToken();
-```
-
-#### Social Login
-
-```typescript
-// Get social login providers
-const providers = await client.auth.getSocialProviders();
-// Returns: SocialProvider[]
-
-// Get social auth URL
-const { url } = await client.auth.getSocialAuthUrl('google');
-// Redirect to this URL
-
-// Handle callback (after redirect)
-const response = await client.auth.socialCallback('google', code);
-// Returns: { member: Member, token: string }
+await client.reservation.cancel('RES-20260115-001', 'Schedule change');
 ```
 
 ### Forms
@@ -681,350 +249,133 @@ const response = await client.auth.socialCallback('google', code);
 ```typescript
 // List forms
 const { data: forms } = await client.forms.list();
-// Returns: ListResponse<Form>
 
-// Get form details
+// Get form with fields
 const form = await client.forms.get('contact');
-// Returns: Form (includes field definitions)
 
-// Submit form (no login required)
+// Submit form
 await client.forms.submit('contact', {
   name: 'John Doe',
-  email: 'user@example.com',
-  message: 'Inquiry content',
+  email: 'john@example.com',
+  message: 'Hello!',
 });
 
-// My submissions (login required)
+// My submissions (auth required)
 const { data: submissions } = await client.forms.mySubmissions();
-// Returns: ListResponse<FormSubmission>
 ```
 
-### Media - Protected
+### Media (Auth Required)
 
 ```typescript
-// Upload file
-const media = await client.media.upload(file); // File or Blob
-// Returns: Media
-
-// Upload multiple files
+// Upload
+const media = await client.media.upload(file);
 const mediaList = await client.media.uploadMultiple([file1, file2]);
-// Returns: Media[]
 
-// List my media
-const { data: mediaList, meta } = await client.media.list({
-  page: 1,
-  per_page: 20,
-  type: 'image/jpeg', // optional
-});
-// Returns: ListResponse<Media>
-
-// Delete media
+// List & Delete
+const { data: myMedia } = await client.media.list({ type: 'image/jpeg' });
 await client.media.delete(mediaId);
 ```
 
-### Entities (Custom Entities) - Dynamic Data Structures
+### Custom Entities
 
-Create entity definitions and manage data directly from the API/SDK.
-
-#### Entity Definition CRUD
+Dynamic data structures for custom use cases.
 
 ```typescript
-// List entities
+// Entity definitions
 const entities = await client.entities.list();
-// Returns: CustomEntity[] (always an array)
+const entity = await client.entities.get('customers');
 
-// Create entity definition
-const entity = await client.entities.create({
+await client.entities.create({
   name: 'Customer',
   slug: 'customers',
-  description: 'Customer management',
   schema: {
     fields: [
-      { name: 'company', label: 'Company Name', type: 'text', required: true },
+      { name: 'company', label: 'Company', type: 'text', required: true },
       { name: 'email', label: 'Email', type: 'email', required: true },
       { name: 'status', label: 'Status', type: 'select', options: [
         { value: 'active', label: 'Active' },
-        { value: 'inactive', label: 'Inactive' }
-      ]}
-    ]
+        { value: 'inactive', label: 'Inactive' },
+      ]},
+    ],
   },
-  icon: 'users'
 });
 
-// Get entity definition (includes schema)
-const entity = await client.entities.get('customers');
-// Returns: CustomEntity (includes schema)
-
-// Update entity definition
-await client.entities.update('customers', {
-  name: 'Clients',
-  description: 'Client management'
-});
-
-// Delete entity definition (requires force if records exist)
-await client.entities.delete('customers');        // When no records exist
-await client.entities.delete('customers', true);  // Force delete with records
-```
-
-#### Record CRUD
+await client.entities.update('customers', { name: 'Clients' });
+await client.entities.delete('customers', true); // force delete
 
-```typescript
-// List records
-const { data: customers, meta } = await client.entities.listRecords('customers', {
-  page: 1,
-  per_page: 20,
-  search: 'ACME',              // Search
-  sort: 'company',             // Sort field
-  dir: 'asc',                  // Sort direction
-  filters: JSON.stringify({ status: 'active' })  // JSON filter
+// Records
+const { data: records } = await client.entities.listRecords('customers', {
+  search: 'ACME',
+  filters: JSON.stringify({ status: 'active' }),
 });
-// Returns: ListResponse<EntityRecord>
+const record = await client.entities.getRecord('customers', 1);
 
-// Get single record
-const customer = await client.entities.getRecord('customers', 1);
-// Returns: EntityRecord
-console.log(customer.data.company); // 'ABC Corp'
-
-// Create record (pass schema fields directly)
-const newCustomer = await client.entities.createRecord('customers', {
-  company: 'ABC Corp',
-  email: 'contact@abc.com',
+await client.entities.createRecord('customers', {
+  company: 'ACME Corp',
+  email: 'contact@acme.com',
   status: 'active',
 });
-
-// Update record (partial update - merges with existing data)
-await client.entities.updateRecord('customers', 1, {
-  status: 'inactive',
-  email: 'new@abc.com'
-});
-
-// Delete record
+await client.entities.updateRecord('customers', 1, { status: 'inactive' });
 await client.entities.deleteRecord('customers', 1);
-```
-
-#### TypeScript Type Support
 
-```typescript
-// Typed entity accessor
+// TypeScript support
 interface Customer {
   company: string;
   email: string;
-  tier: 'standard' | 'vip';
+  status: 'active' | 'inactive';
 }
-
-const customers = client.entities.typed<Customer>('customer');
-
-// Type inference
-const list = await customers.list();
-list.data[0].data.company; // string
-
-const record = await customers.get(1);
-record.data.tier; // 'standard' | 'vip'
-
-// Type checking on create/update
-await customers.create({
-  company: 'New Corp',
-  email: 'new@corp.com',
-  tier: 'standard',
-});
+const customers = client.entities.typed<Customer>('customers');
+const { data } = await customers.list();
 ```
 
-### Site Settings
+### Auth
 
 ```typescript
-// Get theme settings
-const theme = await client.getTheme();
-// Returns: { name, colors, fonts }
+// Register
+await client.auth.register({
+  name: 'John Doe',
+  email: 'john@example.com',
+  password: 'password',
+  password_confirmation: 'password',
+});
 
-// Get site settings
-const settings = await client.getSettings();
-// Returns: Record<string, any>
-```
+// Login/Logout
+const { member, token } = await client.auth.login({
+  email: 'john@example.com',
+  password: 'password',
+});
+await client.auth.logout();
 
-## Types
+// Profile
+const me = await client.auth.me();
+await client.auth.updateProfile({ name: 'New Name' });
 
-### Configuration
+// Token management
+client.setToken('saved-token');
+const token = client.getToken();
+client.isAuthenticated();
 
-```typescript
-interface PromptlyConfig {
-  /** Tenant ID (subdomain) */
-  tenantId: string;
-  /** API key (required) - Get from Dashboard > Settings > API Tokens */
-  apiKey: string;
-  /** Base URL of Promptly API (optional) */
-  baseUrl?: string;
-  /** Request timeout in milliseconds (optional) */
-  timeout?: number;
-}
+// Social login
+const providers = await client.auth.getSocialProviders();
+const { url } = await client.auth.getSocialAuthUrl('google');
+const response = await client.auth.socialCallback('google', code);
 ```
 
-### Common Types
+## Response Types
 
-```typescript
-// Unified list response type
-interface ListResponse<T> {
-  data: T[];
-  meta: PaginationMeta;
-}
-
-interface PaginationMeta {
-  current_page: number;
-  last_page: number;
-  per_page: number;
-  total: number;
-  from: number | null;
-  to: number | null;
-}
-```
-
-### Resource Types
+All list APIs return a consistent format:
 
 ```typescript
-interface Board {
-  id: number;
-  slug: string;
-  name: string;
-  description?: string;
-  is_active: boolean;
-  created_at: string;
-}
-
-interface BoardPost {
-  id: number;
-  board_id: number;
-  title: string;
-  content: string;
-  excerpt?: string;
-  author: string;
-  views: number;
-  is_notice: boolean;
-  is_secret: boolean;
-  is_mine: boolean;
-  is_private: boolean;
-  comment_count: number;
-  attachments?: Media[];
-  created_at: string;
-}
-
-interface BlogPost {
-  id: number;
-  slug: string;
-  title: string;
-  content: string;
-  excerpt?: string;
-  featured_image?: string;
-  category?: string;
-  tags?: string[];
-  author_name?: string;
-  is_published: boolean;
-  published_at?: string;
-  view_count: number;
-  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;
-  name: string;
-  description?: string;
-  price: number;
-  compare_price?: number;
-  thumbnail?: string;
-  images?: string[];
-  status: 'draft' | 'active' | 'inactive';
-  is_featured: boolean;
-  in_stock?: boolean;
-  discount_percent?: number;
-  created_at: string;
-}
-
-interface Reservation {
-  id: number;
-  reservation_number: string;
-  status: 'pending' | 'confirmed' | 'completed' | 'cancelled' | 'no_show';
-  status_label: string;
-  reservation_date: string;
-  start_time: string;
-  end_time: string;
-  time_range: string;
-  customer_name: string;
-  customer_phone: string | null;
-  customer_email: string | null;
-  price: number;
-  deposit: number;
-  payment_status: 'pending' | 'paid' | 'refunded' | 'partial';
-  can_cancel: boolean;
-  service: { id: number; name: string; duration: number; } | null;
-  staff: { id: number; name: string; avatar: string | null; } | null;
-  created_at: string;
-}
-
-interface ReservationService {
-  id: number;
-  name: string;
-  slug: string;
-  description: string | null;
-  thumbnail: string | null;
-  duration: number;
-  price: number;
-  requires_staff: boolean;
-  requires_payment: boolean;
-  deposit: number;
-  staffs: Array<{ id: number; name: string; avatar: string | null; }>;
-}
-
-interface ReservationSettings {
-  timezone: string;
-  slot_interval: number;
-  min_notice_hours: number;
-  max_advance_days: number;
-  cancellation_hours: number;
-  allow_online_payment: boolean;
-  bookable_date_range: { start: string; end: string; };
-}
-
-interface Member {
-  id: number;
-  name: string;
-  email: string;
-  phone?: string;
-  avatar?: string;
-  is_active: boolean;
-  created_at: string;
-}
-
-interface CustomEntity {
-  id: number;
-  name: string;
-  slug: string;
-  description?: string;
-  schema: EntitySchema;
-  is_active: boolean;
-  created_at: string;
-}
-
-interface EntityRecord {
-  id: number;
-  entity_id: number;
-  data: Record<string, any>;
-  status: 'active' | 'archived' | 'draft';
-  created_at: string;
-  updated_at: string;
+interface ListResponse<T> {
+  data: T[];  // Always an array, never null
+  meta: {
+    current_page: number;
+    last_page: number;
+    per_page: number;
+    total: number;
+    from: number | null;
+    to: number | null;
+  };
 }
 ```
 
@@ -1052,23 +403,20 @@ import { Promptly } from '@back23/promptly-sdk';
 
 const client = new Promptly({
   tenantId: 'demo',
-  apiKey: process.env.NEXT_PUBLIC_PROMPTLY_API_KEY!, // Required
-  baseUrl: 'https://promptly.webbyon.com',
+  apiKey: process.env.NEXT_PUBLIC_PROMPTLY_API_KEY!,
 });
 
-// Blog post list (with pagination)
 function BlogList() {
   const [posts, setPosts] = useState([]);
-  const [meta, setMeta] = useState(null);
-  const [page, setPage] = useState(1);
+  const [loading, setLoading] = useState(true);
 
   useEffect(() => {
-    client.blog.list({ page, per_page: 10 })
-      .then(({ data, meta }) => {
-        setPosts(data);  // Always an array
-        setMeta(meta);
-      });
-  }, [page]);
+    client.blog.list({ per_page: 10 })
+      .then(({ data }) => setPosts(data))
+      .finally(() => setLoading(false));
+  }, []);
+
+  if (loading) return <div>Loading...</div>;
 
   return (
     <div>
@@ -1076,83 +424,33 @@ function BlogList() {
         <article key={post.id}>
           <h2>{post.title}</h2>
           <p>{post.excerpt}</p>
+          <span>{post.category}</span>
+          {post.tags.map(tag => <span key={tag}>{tag}</span>)}
         </article>
       ))}
-
-      {meta && (
-        <div>
-          Page {meta.current_page} of {meta.last_page}
-          <button
-            onClick={() => setPage(p => p - 1)}
-            disabled={page <= 1}
-          >
-            Previous
-          </button>
-          <button
-            onClick={() => setPage(p => p + 1)}
-            disabled={page >= meta.last_page}
-          >
-            Next
-          </button>
-        </div>
-      )}
     </div>
   );
 }
+```
 
-// Reservation form
-function ReservationForm() {
-  const [services, setServices] = useState([]);
-  const [selectedService, setSelectedService] = useState(null);
-  const [dates, setDates] = useState([]);
-  const [slots, setSlots] = useState([]);
+## Changelog
 
-  useEffect(() => {
-    client.reservation.listServices().then(setServices);
-  }, []);
+### v2.12.0
+- Added `category`, `tags`, `views`, `published_at` fields to BlogPost response
+- Added `GET /blog/categories` and `GET /blog/tags` endpoints
 
-  useEffect(() => {
-    if (selectedService) {
-      client.reservation.getAvailableDates({
-        service_id: selectedService,
-      }).then(setDates);
-    }
-  }, [selectedService]);
-
-  const handleDateSelect = async (date) => {
-    const availableSlots = await client.reservation.getAvailableSlots({
-      service_id: selectedService,
-      date,
-    });
-    setSlots(availableSlots);
-  };
+### v2.5.0
+- Added `is_secret` and `is_mine` fields to BoardPost
 
-  return (
-    <div>
-      <select onChange={e => setSelectedService(Number(e.target.value))}>
-        <option>Select a service</option>
-        {services.map(s => (
-          <option key={s.id} value={s.id}>{s.name}</option>
-        ))}
-      </select>
-
-      <div>
-        {dates.map(date => (
-          <button key={date} onClick={() => handleDateSelect(date)}>
-            {date}
-          </button>
-        ))}
-      </div>
-
-      <div>
-        {slots.filter(s => s.available).map(slot => (
-          <button key={slot.time}>{slot.time}</button>
-        ))}
-      </div>
-    </div>
-  );
-}
-```
+### v2.3.0
+- Polymorphic comments API (board, blog, standalone)
+
+### v2.0.0
+- **Breaking:** API key required for all requests
+
+### v1.3.0
+- Unified `ListResponse<T>` format for all list APIs
+- Reservation system support
 
 ## License
 

package/package.json

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