@back23/promptly-sdk 2.2.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/package.json

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