@back23/promptly-sdk 2.1.0 → 2.2.1

package/README.md

@@ -24,6 +24,55 @@ const { data: posts } = await client.blog.list();
 const products = await client.shop.listProducts();
 ```
 
+## 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
@@ -94,7 +143,7 @@ data.map(post => ...);  // data is always an array
 | **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
@@ -477,60 +526,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 타입 지원

package/dist/index.d.mts

@@ -621,6 +621,25 @@ interface UpdateEntityRecordData {
     data?: Record<string, any>;
     status?: 'active' | 'archived' | 'draft';
 }
+interface CreateEntityData {
+    name: string;
+    slug?: string;
+    description?: string;
+    schema: EntitySchema;
+    settings?: Record<string, any>;
+    icon?: string;
+    is_active?: boolean;
+}
+interface UpdateEntityData {
+    name?: string;
+    slug?: string;
+    description?: string;
+    schema?: EntitySchema;
+    settings?: Record<string, any>;
+    icon?: string;
+    is_active?: boolean;
+    sort_order?: number;
+}
 
 /**
  * Reservation types for Promptly SDK
@@ -805,7 +824,7 @@ declare class HttpClient {
     /**
      * DELETE request
      */
-    delete<T>(endpoint: string): Promise<T>;
+    delete<T>(endpoint: string, params?: Record<string, any>): Promise<T>;
     /**
      * Upload file
      */
@@ -1159,25 +1178,80 @@ declare class EntitiesResource {
     private http;
     constructor(http: HttpClient);
     /**
-     * List all active custom entities
-     * @returns Array of entities (always an array)
+     * List all custom entities
+     * @returns Array of entities
      *
      * @example
      * ```typescript
      * const entities = await client.entities.list();
-     * // [{ id: 1, name: 'Customer', slug: 'customer', ... }]
+     * // [{ id: 1, name: 'Customer', slug: 'customer', records_count: 150, ... }]
      * ```
      */
     list(): Promise<CustomEntity[]>;
     /**
-     * Get entity schema by slug
+     * Create a new entity definition
      *
      * @example
      * ```typescript
-     * const schema = await client.entities.getSchema('customer');
-     * // { fields: [{ name: 'company', label: '회사명', type: 'text', ... }] }
+     * 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'
+     * });
      * ```
      */
+    create(data: CreateEntityData): Promise<CustomEntity>;
+    /**
+     * Get entity definition by slug (includes schema)
+     *
+     * @example
+     * ```typescript
+     * const entity = await client.entities.get('customers');
+     * console.log(entity.schema.fields);
+     * ```
+     */
+    get(slug: string): Promise<CustomEntity>;
+    /**
+     * Update an entity definition
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.entities.update('customers', {
+     *   name: '고객사',
+     *   description: '고객사 관리'
+     * });
+     * ```
+     */
+    update(slug: string, data: UpdateEntityData): Promise<CustomEntity>;
+    /**
+     * Delete an entity definition
+     * If entity has records, use force=true to delete anyway
+     *
+     * @example
+     * ```typescript
+     * // Will fail if entity has records
+     * await client.entities.delete('customers');
+     *
+     * // Force delete with all records
+     * await client.entities.delete('customers', true);
+     * ```
+     */
+    delete(slug: string, force?: boolean): Promise<void>;
+    /**
+     * Get entity schema (convenience method)
+     * @deprecated Use get(slug) instead - it includes schema
+     */
     getSchema(slug: string): Promise<EntitySchema>;
     /**
      * List records for an entity
@@ -1186,18 +1260,20 @@ declare class EntitiesResource {
      * @example
      * ```typescript
      * // Basic listing
-     * const customers = await client.entities.listRecords('customer');
+     * const customers = await client.entities.listRecords('customers');
      *
-     * // With pagination
-     * const customers = await client.entities.listRecords('customer', {
+     * // With pagination and search
+     * const customers = await client.entities.listRecords('customers', {
      *   page: 1,
      *   per_page: 20,
-     *   status: 'active',
+     *   search: 'ACME',
+     *   sort: 'company',
+     *   dir: 'asc'
      * });
      *
-     * // With filtering by data fields
-     * const vipCustomers = await client.entities.listRecords('customer', {
-     *   'data.tier': 'vip',
+     * // With filtering
+     * const vipCustomers = await client.entities.listRecords('customers', {
+     *   filters: JSON.stringify({ tier: 'vip' })
      * });
      * ```
      */
@@ -1207,46 +1283,44 @@ declare class EntitiesResource {
      *
      * @example
      * ```typescript
-     * const customer = await client.entities.getRecord('customer', 1);
+     * const customer = await client.entities.getRecord('customers', 1);
      * console.log(customer.data.company); // 'ABC Corp'
      * ```
      */
     getRecord(slug: string, id: number): Promise<EntityRecord>;
     /**
      * Create a new record
+     * Request body fields are defined by entity schema
      *
      * @example
      * ```typescript
-     * const newCustomer = await client.entities.createRecord('customer', {
-     *   data: {
-     *     company: 'ABC Corp',
-     *     email: 'contact@abc.com',
-     *     tier: 'standard',
-     *   },
-     *   status: 'active',
+     * const newCustomer = await client.entities.createRecord('customers', {
+     *   company: 'ABC Corp',
+     *   email: 'contact@abc.com',
+     *   tier: 'standard',
      * });
      * ```
      */
-    createRecord(slug: string, data: CreateEntityRecordData): Promise<EntityRecord>;
+    createRecord(slug: string, data: Record<string, any>): Promise<EntityRecord>;
     /**
      * Update a record
+     * Only provided fields will be updated, existing data is preserved
      *
      * @example
      * ```typescript
-     * const updated = await client.entities.updateRecord('customer', 1, {
-     *   data: {
-     *     tier: 'vip',
-     *   },
+     * const updated = await client.entities.updateRecord('customers', 1, {
+     *   tier: 'vip',
+     *   email: 'new@abc.com'
      * });
      * ```
      */
-    updateRecord(slug: string, id: number, data: UpdateEntityRecordData): Promise<EntityRecord>;
+    updateRecord(slug: string, id: number, data: Record<string, any>): Promise<EntityRecord>;
     /**
      * Delete a record
      *
      * @example
      * ```typescript
-     * await client.entities.deleteRecord('customer', 1);
+     * await client.entities.deleteRecord('customers', 1);
      * ```
      */
     deleteRecord(slug: string, id: number): Promise<void>;
@@ -1255,7 +1329,7 @@ declare class EntitiesResource {
      *
      * @example
      * ```typescript
-     * const record = await client.entities.getRecord('customer', 1);
+     * const record = await client.entities.getRecord('customers', 1);
      * const company = client.entities.getValue(record, 'company');
      * ```
      */
@@ -1271,7 +1345,7 @@ declare class EntitiesResource {
      *   tier: 'standard' | 'vip';
      * }
      *
-     * const customers = client.entities.typed<Customer>('customer');
+     * const customers = client.entities.typed<Customer>('customers');
      * const list = await customers.list(); // Typed records
      * const record = await customers.get(1);
      * console.log(record.data.company); // TypeScript knows this is string
@@ -1287,10 +1361,10 @@ declare class EntitiesResource {
         get: (id: number) => Promise<Omit<EntityRecord, "data"> & {
             data: T;
         }>;
-        create: (data: T, status?: EntityRecord["status"]) => Promise<Omit<EntityRecord, "data"> & {
+        create: (data: T) => Promise<Omit<EntityRecord, "data"> & {
             data: T;
         }>;
-        update: (id: number, data: Partial<T>, status?: EntityRecord["status"]) => Promise<Omit<EntityRecord, "data"> & {
+        update: (id: number, data: Partial<T>) => Promise<Omit<EntityRecord, "data"> & {
             data: T;
         }>;
         delete: (id: number) => Promise<void>;
@@ -1448,4 +1522,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 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 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 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

@@ -621,6 +621,25 @@ interface UpdateEntityRecordData {
     data?: Record<string, any>;
     status?: 'active' | 'archived' | 'draft';
 }
+interface CreateEntityData {
+    name: string;
+    slug?: string;
+    description?: string;
+    schema: EntitySchema;
+    settings?: Record<string, any>;
+    icon?: string;
+    is_active?: boolean;
+}
+interface UpdateEntityData {
+    name?: string;
+    slug?: string;
+    description?: string;
+    schema?: EntitySchema;
+    settings?: Record<string, any>;
+    icon?: string;
+    is_active?: boolean;
+    sort_order?: number;
+}
 
 /**
  * Reservation types for Promptly SDK
@@ -805,7 +824,7 @@ declare class HttpClient {
     /**
      * DELETE request
      */
-    delete<T>(endpoint: string): Promise<T>;
+    delete<T>(endpoint: string, params?: Record<string, any>): Promise<T>;
     /**
      * Upload file
      */
@@ -1159,25 +1178,80 @@ declare class EntitiesResource {
     private http;
     constructor(http: HttpClient);
     /**
-     * List all active custom entities
-     * @returns Array of entities (always an array)
+     * List all custom entities
+     * @returns Array of entities
      *
      * @example
      * ```typescript
      * const entities = await client.entities.list();
-     * // [{ id: 1, name: 'Customer', slug: 'customer', ... }]
+     * // [{ id: 1, name: 'Customer', slug: 'customer', records_count: 150, ... }]
      * ```
      */
     list(): Promise<CustomEntity[]>;
     /**
-     * Get entity schema by slug
+     * Create a new entity definition
      *
      * @example
      * ```typescript
-     * const schema = await client.entities.getSchema('customer');
-     * // { fields: [{ name: 'company', label: '회사명', type: 'text', ... }] }
+     * 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'
+     * });
      * ```
      */
+    create(data: CreateEntityData): Promise<CustomEntity>;
+    /**
+     * Get entity definition by slug (includes schema)
+     *
+     * @example
+     * ```typescript
+     * const entity = await client.entities.get('customers');
+     * console.log(entity.schema.fields);
+     * ```
+     */
+    get(slug: string): Promise<CustomEntity>;
+    /**
+     * Update an entity definition
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.entities.update('customers', {
+     *   name: '고객사',
+     *   description: '고객사 관리'
+     * });
+     * ```
+     */
+    update(slug: string, data: UpdateEntityData): Promise<CustomEntity>;
+    /**
+     * Delete an entity definition
+     * If entity has records, use force=true to delete anyway
+     *
+     * @example
+     * ```typescript
+     * // Will fail if entity has records
+     * await client.entities.delete('customers');
+     *
+     * // Force delete with all records
+     * await client.entities.delete('customers', true);
+     * ```
+     */
+    delete(slug: string, force?: boolean): Promise<void>;
+    /**
+     * Get entity schema (convenience method)
+     * @deprecated Use get(slug) instead - it includes schema
+     */
     getSchema(slug: string): Promise<EntitySchema>;
     /**
      * List records for an entity
@@ -1186,18 +1260,20 @@ declare class EntitiesResource {
      * @example
      * ```typescript
      * // Basic listing
-     * const customers = await client.entities.listRecords('customer');
+     * const customers = await client.entities.listRecords('customers');
      *
-     * // With pagination
-     * const customers = await client.entities.listRecords('customer', {
+     * // With pagination and search
+     * const customers = await client.entities.listRecords('customers', {
      *   page: 1,
      *   per_page: 20,
-     *   status: 'active',
+     *   search: 'ACME',
+     *   sort: 'company',
+     *   dir: 'asc'
      * });
      *
-     * // With filtering by data fields
-     * const vipCustomers = await client.entities.listRecords('customer', {
-     *   'data.tier': 'vip',
+     * // With filtering
+     * const vipCustomers = await client.entities.listRecords('customers', {
+     *   filters: JSON.stringify({ tier: 'vip' })
      * });
      * ```
      */
@@ -1207,46 +1283,44 @@ declare class EntitiesResource {
      *
      * @example
      * ```typescript
-     * const customer = await client.entities.getRecord('customer', 1);
+     * const customer = await client.entities.getRecord('customers', 1);
      * console.log(customer.data.company); // 'ABC Corp'
      * ```
      */
     getRecord(slug: string, id: number): Promise<EntityRecord>;
     /**
      * Create a new record
+     * Request body fields are defined by entity schema
      *
      * @example
      * ```typescript
-     * const newCustomer = await client.entities.createRecord('customer', {
-     *   data: {
-     *     company: 'ABC Corp',
-     *     email: 'contact@abc.com',
-     *     tier: 'standard',
-     *   },
-     *   status: 'active',
+     * const newCustomer = await client.entities.createRecord('customers', {
+     *   company: 'ABC Corp',
+     *   email: 'contact@abc.com',
+     *   tier: 'standard',
      * });
      * ```
      */
-    createRecord(slug: string, data: CreateEntityRecordData): Promise<EntityRecord>;
+    createRecord(slug: string, data: Record<string, any>): Promise<EntityRecord>;
     /**
      * Update a record
+     * Only provided fields will be updated, existing data is preserved
      *
      * @example
      * ```typescript
-     * const updated = await client.entities.updateRecord('customer', 1, {
-     *   data: {
-     *     tier: 'vip',
-     *   },
+     * const updated = await client.entities.updateRecord('customers', 1, {
+     *   tier: 'vip',
+     *   email: 'new@abc.com'
      * });
      * ```
      */
-    updateRecord(slug: string, id: number, data: UpdateEntityRecordData): Promise<EntityRecord>;
+    updateRecord(slug: string, id: number, data: Record<string, any>): Promise<EntityRecord>;
     /**
      * Delete a record
      *
      * @example
      * ```typescript
-     * await client.entities.deleteRecord('customer', 1);
+     * await client.entities.deleteRecord('customers', 1);
      * ```
      */
     deleteRecord(slug: string, id: number): Promise<void>;
@@ -1255,7 +1329,7 @@ declare class EntitiesResource {
      *
      * @example
      * ```typescript
-     * const record = await client.entities.getRecord('customer', 1);
+     * const record = await client.entities.getRecord('customers', 1);
      * const company = client.entities.getValue(record, 'company');
      * ```
      */
@@ -1271,7 +1345,7 @@ declare class EntitiesResource {
      *   tier: 'standard' | 'vip';
      * }
      *
-     * const customers = client.entities.typed<Customer>('customer');
+     * const customers = client.entities.typed<Customer>('customers');
      * const list = await customers.list(); // Typed records
      * const record = await customers.get(1);
      * console.log(record.data.company); // TypeScript knows this is string
@@ -1287,10 +1361,10 @@ declare class EntitiesResource {
         get: (id: number) => Promise<Omit<EntityRecord, "data"> & {
             data: T;
         }>;
-        create: (data: T, status?: EntityRecord["status"]) => Promise<Omit<EntityRecord, "data"> & {
+        create: (data: T) => Promise<Omit<EntityRecord, "data"> & {
             data: T;
         }>;
-        update: (id: number, data: Partial<T>, status?: EntityRecord["status"]) => Promise<Omit<EntityRecord, "data"> & {
+        update: (id: number, data: Partial<T>) => Promise<Omit<EntityRecord, "data"> & {
             data: T;
         }>;
         delete: (id: number) => Promise<void>;
@@ -1448,4 +1522,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 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 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 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

@@ -212,8 +212,8 @@ var HttpClient = class {
   /**
    * DELETE request
    */
-  delete(endpoint) {
-    return this.request(endpoint, { method: "DELETE" });
+  delete(endpoint, params) {
+    return this.request(endpoint, { method: "DELETE", params });
   }
   /**
    * Upload file
@@ -804,16 +804,16 @@ var EntitiesResource = class {
     this.http = http;
   }
   // ============================================
-  // Entities (Public)
+  // Entity Definitions CRUD
   // ============================================
   /**
-   * List all active custom entities
-   * @returns Array of entities (always an array)
+   * List all custom entities
+   * @returns Array of entities
    *
    * @example
    * ```typescript
    * const entities = await client.entities.list();
-   * // [{ id: 1, name: 'Customer', slug: 'customer', ... }]
+   * // [{ id: 1, name: 'Customer', slug: 'customer', records_count: 150, ... }]
    * ```
    */
   async list() {
@@ -821,19 +821,84 @@ var EntitiesResource = class {
     return response.data;
   }
   /**
-   * Get entity schema by slug
+   * Create a new entity definition
    *
    * @example
    * ```typescript
-   * const schema = await client.entities.getSchema('customer');
-   * // { fields: [{ name: 'company', label: '회사명', type: 'text', ... }] }
+   * 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'
+   * });
+   * ```
+   */
+  async create(data) {
+    return this.http.post("/entities", data);
+  }
+  /**
+   * Get entity definition by slug (includes schema)
+   *
+   * @example
+   * ```typescript
+   * const entity = await client.entities.get('customers');
+   * console.log(entity.schema.fields);
+   * ```
+   */
+  async get(slug) {
+    return this.http.get(`/entities/${slug}`);
+  }
+  /**
+   * Update an entity definition
+   *
+   * @example
+   * ```typescript
+   * const updated = await client.entities.update('customers', {
+   *   name: '고객사',
+   *   description: '고객사 관리'
+   * });
    * ```
    */
+  async update(slug, data) {
+    return this.http.put(`/entities/${slug}`, data);
+  }
+  /**
+   * Delete an entity definition
+   * If entity has records, use force=true to delete anyway
+   *
+   * @example
+   * ```typescript
+   * // Will fail if entity has records
+   * await client.entities.delete('customers');
+   *
+   * // Force delete with all records
+   * await client.entities.delete('customers', true);
+   * ```
+   */
+  async delete(slug, force = false) {
+    const params = force ? { force: "true" } : void 0;
+    return this.http.delete(`/entities/${slug}`, params);
+  }
+  /**
+   * Get entity schema (convenience method)
+   * @deprecated Use get(slug) instead - it includes schema
+   */
   async getSchema(slug) {
-    return this.http.get(`/entities/${slug}/schema`);
+    const entity = await this.get(slug);
+    return entity.schema;
   }
   // ============================================
-  // Records (Public Read)
+  // Records CRUD
   // ============================================
   /**
    * List records for an entity
@@ -842,82 +907,79 @@ var EntitiesResource = class {
    * @example
    * ```typescript
    * // Basic listing
-   * const customers = await client.entities.listRecords('customer');
+   * const customers = await client.entities.listRecords('customers');
    *
-   * // With pagination
-   * const customers = await client.entities.listRecords('customer', {
+   * // With pagination and search
+   * const customers = await client.entities.listRecords('customers', {
    *   page: 1,
    *   per_page: 20,
-   *   status: 'active',
+   *   search: 'ACME',
+   *   sort: 'company',
+   *   dir: 'asc'
    * });
    *
-   * // With filtering by data fields
-   * const vipCustomers = await client.entities.listRecords('customer', {
-   *   'data.tier': 'vip',
+   * // With filtering
+   * const vipCustomers = await client.entities.listRecords('customers', {
+   *   filters: JSON.stringify({ tier: 'vip' })
    * });
    * ```
    */
   async listRecords(slug, params) {
-    return this.http.getList(`/entities/${slug}`, params);
+    return this.http.getList(`/entities/${slug}/records`, params);
   }
   /**
    * Get a single record by ID
    *
    * @example
    * ```typescript
-   * const customer = await client.entities.getRecord('customer', 1);
+   * const customer = await client.entities.getRecord('customers', 1);
    * console.log(customer.data.company); // 'ABC Corp'
    * ```
    */
   async getRecord(slug, id) {
-    return this.http.get(`/entities/${slug}/${id}`);
+    return this.http.get(`/entities/${slug}/records/${id}`);
   }
-  // ============================================
-  // Records (Protected - requires auth)
-  // ============================================
   /**
    * Create a new record
+   * Request body fields are defined by entity schema
    *
    * @example
    * ```typescript
-   * const newCustomer = await client.entities.createRecord('customer', {
-   *   data: {
-   *     company: 'ABC Corp',
-   *     email: 'contact@abc.com',
-   *     tier: 'standard',
-   *   },
-   *   status: 'active',
+   * const newCustomer = await client.entities.createRecord('customers', {
+   *   company: 'ABC Corp',
+   *   email: 'contact@abc.com',
+   *   tier: 'standard',
    * });
    * ```
    */
   async createRecord(slug, data) {
-    return this.http.post(`/entities/${slug}`, data);
+    return this.http.post(`/entities/${slug}/records`, data);
   }
   /**
    * Update a record
+   * Only provided fields will be updated, existing data is preserved
    *
    * @example
    * ```typescript
-   * const updated = await client.entities.updateRecord('customer', 1, {
-   *   data: {
-   *     tier: 'vip',
-   *   },
+   * const updated = await client.entities.updateRecord('customers', 1, {
+   *   tier: 'vip',
+   *   email: 'new@abc.com'
    * });
    * ```
    */
   async updateRecord(slug, id, data) {
-    return this.http.put(`/entities/${slug}/${id}`, data);
+    return this.http.put(`/entities/${slug}/records/${id}`, data);
   }
   /**
    * Delete a record
    *
    * @example
    * ```typescript
-   * await client.entities.deleteRecord('customer', 1);
+   * await client.entities.deleteRecord('customers', 1);
    * ```
    */
   async deleteRecord(slug, id) {
-    return this.http.delete(`/entities/${slug}/${id}`);
+    return this.http.delete(`/entities/${slug}/records/${id}`);
   }
   // ============================================
   // Helper Methods
@@ -927,7 +989,7 @@ var EntitiesResource = class {
    *
    * @example
    * ```typescript
-   * const record = await client.entities.getRecord('customer', 1);
+   * const record = await client.entities.getRecord('customers', 1);
    * const company = client.entities.getValue(record, 'company');
    * ```
    */
@@ -945,7 +1007,7 @@ var EntitiesResource = class {
    *   tier: 'standard' | 'vip';
    * }
    *
-   * const customers = client.entities.typed<Customer>('customer');
+   * const customers = client.entities.typed<Customer>('customers');
    * const list = await customers.list(); // Typed records
    * const record = await customers.get(1);
    * console.log(record.data.company); // TypeScript knows this is string
@@ -964,12 +1026,12 @@ var EntitiesResource = class {
         const record = await this.getRecord(slug, id);
         return record;
       },
-      create: async (data, status) => {
-        const record = await this.createRecord(slug, { data, status });
+      create: async (data) => {
+        const record = await this.createRecord(slug, data);
         return record;
       },
-      update: async (id, data, status) => {
-        const record = await this.updateRecord(slug, id, { data, status });
+      update: async (id, data) => {
+        const record = await this.updateRecord(slug, id, data);
         return record;
       },
       delete: (id) => this.deleteRecord(slug, id)

package/dist/index.mjs

@@ -184,8 +184,8 @@ var HttpClient = class {
   /**
    * DELETE request
    */
-  delete(endpoint) {
-    return this.request(endpoint, { method: "DELETE" });
+  delete(endpoint, params) {
+    return this.request(endpoint, { method: "DELETE", params });
   }
   /**
    * Upload file
@@ -776,16 +776,16 @@ var EntitiesResource = class {
     this.http = http;
   }
   // ============================================
-  // Entities (Public)
+  // Entity Definitions CRUD
   // ============================================
   /**
-   * List all active custom entities
-   * @returns Array of entities (always an array)
+   * List all custom entities
+   * @returns Array of entities
    *
    * @example
    * ```typescript
    * const entities = await client.entities.list();
-   * // [{ id: 1, name: 'Customer', slug: 'customer', ... }]
+   * // [{ id: 1, name: 'Customer', slug: 'customer', records_count: 150, ... }]
    * ```
    */
   async list() {
@@ -793,19 +793,84 @@ var EntitiesResource = class {
     return response.data;
   }
   /**
-   * Get entity schema by slug
+   * Create a new entity definition
    *
    * @example
    * ```typescript
-   * const schema = await client.entities.getSchema('customer');
-   * // { fields: [{ name: 'company', label: '회사명', type: 'text', ... }] }
+   * 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'
+   * });
+   * ```
+   */
+  async create(data) {
+    return this.http.post("/entities", data);
+  }
+  /**
+   * Get entity definition by slug (includes schema)
+   *
+   * @example
+   * ```typescript
+   * const entity = await client.entities.get('customers');
+   * console.log(entity.schema.fields);
+   * ```
+   */
+  async get(slug) {
+    return this.http.get(`/entities/${slug}`);
+  }
+  /**
+   * Update an entity definition
+   *
+   * @example
+   * ```typescript
+   * const updated = await client.entities.update('customers', {
+   *   name: '고객사',
+   *   description: '고객사 관리'
+   * });
    * ```
    */
+  async update(slug, data) {
+    return this.http.put(`/entities/${slug}`, data);
+  }
+  /**
+   * Delete an entity definition
+   * If entity has records, use force=true to delete anyway
+   *
+   * @example
+   * ```typescript
+   * // Will fail if entity has records
+   * await client.entities.delete('customers');
+   *
+   * // Force delete with all records
+   * await client.entities.delete('customers', true);
+   * ```
+   */
+  async delete(slug, force = false) {
+    const params = force ? { force: "true" } : void 0;
+    return this.http.delete(`/entities/${slug}`, params);
+  }
+  /**
+   * Get entity schema (convenience method)
+   * @deprecated Use get(slug) instead - it includes schema
+   */
   async getSchema(slug) {
-    return this.http.get(`/entities/${slug}/schema`);
+    const entity = await this.get(slug);
+    return entity.schema;
   }
   // ============================================
-  // Records (Public Read)
+  // Records CRUD
   // ============================================
   /**
    * List records for an entity
@@ -814,82 +879,79 @@ var EntitiesResource = class {
    * @example
    * ```typescript
    * // Basic listing
-   * const customers = await client.entities.listRecords('customer');
+   * const customers = await client.entities.listRecords('customers');
    *
-   * // With pagination
-   * const customers = await client.entities.listRecords('customer', {
+   * // With pagination and search
+   * const customers = await client.entities.listRecords('customers', {
    *   page: 1,
    *   per_page: 20,
-   *   status: 'active',
+   *   search: 'ACME',
+   *   sort: 'company',
+   *   dir: 'asc'
    * });
    *
-   * // With filtering by data fields
-   * const vipCustomers = await client.entities.listRecords('customer', {
-   *   'data.tier': 'vip',
+   * // With filtering
+   * const vipCustomers = await client.entities.listRecords('customers', {
+   *   filters: JSON.stringify({ tier: 'vip' })
    * });
    * ```
    */
   async listRecords(slug, params) {
-    return this.http.getList(`/entities/${slug}`, params);
+    return this.http.getList(`/entities/${slug}/records`, params);
   }
   /**
    * Get a single record by ID
    *
    * @example
    * ```typescript
-   * const customer = await client.entities.getRecord('customer', 1);
+   * const customer = await client.entities.getRecord('customers', 1);
    * console.log(customer.data.company); // 'ABC Corp'
    * ```
    */
   async getRecord(slug, id) {
-    return this.http.get(`/entities/${slug}/${id}`);
+    return this.http.get(`/entities/${slug}/records/${id}`);
   }
-  // ============================================
-  // Records (Protected - requires auth)
-  // ============================================
   /**
    * Create a new record
+   * Request body fields are defined by entity schema
    *
    * @example
    * ```typescript
-   * const newCustomer = await client.entities.createRecord('customer', {
-   *   data: {
-   *     company: 'ABC Corp',
-   *     email: 'contact@abc.com',
-   *     tier: 'standard',
-   *   },
-   *   status: 'active',
+   * const newCustomer = await client.entities.createRecord('customers', {
+   *   company: 'ABC Corp',
+   *   email: 'contact@abc.com',
+   *   tier: 'standard',
    * });
    * ```
    */
   async createRecord(slug, data) {
-    return this.http.post(`/entities/${slug}`, data);
+    return this.http.post(`/entities/${slug}/records`, data);
   }
   /**
    * Update a record
+   * Only provided fields will be updated, existing data is preserved
    *
    * @example
    * ```typescript
-   * const updated = await client.entities.updateRecord('customer', 1, {
-   *   data: {
-   *     tier: 'vip',
-   *   },
+   * const updated = await client.entities.updateRecord('customers', 1, {
+   *   tier: 'vip',
+   *   email: 'new@abc.com'
    * });
    * ```
    */
   async updateRecord(slug, id, data) {
-    return this.http.put(`/entities/${slug}/${id}`, data);
+    return this.http.put(`/entities/${slug}/records/${id}`, data);
   }
   /**
    * Delete a record
    *
    * @example
    * ```typescript
-   * await client.entities.deleteRecord('customer', 1);
+   * await client.entities.deleteRecord('customers', 1);
    * ```
    */
   async deleteRecord(slug, id) {
-    return this.http.delete(`/entities/${slug}/${id}`);
+    return this.http.delete(`/entities/${slug}/records/${id}`);
   }
   // ============================================
   // Helper Methods
@@ -899,7 +961,7 @@ var EntitiesResource = class {
    *
    * @example
    * ```typescript
-   * const record = await client.entities.getRecord('customer', 1);
+   * const record = await client.entities.getRecord('customers', 1);
    * const company = client.entities.getValue(record, 'company');
    * ```
    */
@@ -917,7 +979,7 @@ var EntitiesResource = class {
    *   tier: 'standard' | 'vip';
    * }
    *
-   * const customers = client.entities.typed<Customer>('customer');
+   * const customers = client.entities.typed<Customer>('customers');
    * const list = await customers.list(); // Typed records
    * const record = await customers.get(1);
    * console.log(record.data.company); // TypeScript knows this is string
@@ -936,12 +998,12 @@ var EntitiesResource = class {
         const record = await this.getRecord(slug, id);
         return record;
       },
-      create: async (data, status) => {
-        const record = await this.createRecord(slug, { data, status });
+      create: async (data) => {
+        const record = await this.createRecord(slug, data);
         return record;
       },
-      update: async (id, data, status) => {
-        const record = await this.updateRecord(slug, id, { data, status });
+      update: async (id, data) => {
+        const record = await this.updateRecord(slug, id, data);
         return record;
       },
       delete: (id) => this.deleteRecord(slug, id)

package/package.json

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