@designbasekorea/figma-license-core 0.2.1 → 0.3.0

package/docs/PLUGIN_INTEGRATION_KO.md

@@ -8,7 +8,7 @@
   - 키가 있는지 (`hasLicenseKey`)
   - 실제 유효 등록인지 (`isLicenseRegistered`)
 - 유료/무료 티어별 사용 범위 통일
-  - 일일 N회, 월간 N회, 무제한
+  - 일일 N회, 주간 N회, 월간 N회, 무제한
 - 티어별 기능 제한 통일
   - 예: 무료는 무제한 사용 가능하지만 일부 기능 차단
 
@@ -211,7 +211,7 @@ import { PageLicense } from '@designbasekorea/figma-ui';
 - `planTier`
 - `remainingUsage`
 - `usageUsed`
-- `usageReset` (`none`/`daily`/`monthly`)
+- `usageReset` (`none`/`daily`/`weekly`/`monthly`)
 - `usageReason` (`USAGE_LIMIT_REACHED`/`FEATURE_NOT_ALLOWED`)
 - `licenseStatus`
 - `licenseSource`
@@ -223,6 +223,7 @@ import { PageLicense } from '@designbasekorea/figma-ui';
 UI 예시:
 
 - FREE + daily + 10회 정책: "오늘 남은 횟수 6/10"
+- FREE + weekly + 30회 정책: "이번 주 남은 횟수 18/30"
 - PRO + monthly + 20회 정책: "이번 달 남은 횟수 12/20"
 - FREE + unlimited + feature deny: "사용 횟수 제한 없음, 고급 기능 잠김"
 
@@ -241,7 +242,9 @@ parent.postMessage({ pluginMessage: { type: 'check-feature-access', featureKey:
 
 ## 5) 사용량 소모 처리
 
-기능 성공 후 사용량 소모:
+기능 실행 전 접근 가능 여부를 확인하고, 실제 작업을 시작하기 직전에 사용량을 소모합니다.
+`amount`가 남은 수량보다 크면 코어가 소비하지 않습니다. 소비된 시도는 작업이
+외부 API 오류로 실패하더라도 재시도로 한도를 우회하지 못하도록 사용량에 포함됩니다.
 
 ```ts
 parent.postMessage({ pluginMessage: { type: 'consume-usage', amount: 1, featureKey: 'bulk_apply' } }, '*');
@@ -249,7 +252,7 @@ parent.postMessage({ pluginMessage: { type: 'consume-usage', amount: 1, featureK
 
 응답: `usage-consume-result`
 
-- `success`가 `true`면 소모 완료
+- `success`가 `true`면 소모 완료. 마지막 1회 소비도 `success: true`, `remaining: 0`입니다.
 - `success`가 `false`면 차단 상태
 
 ## 6) 정책 샘플
@@ -267,6 +270,16 @@ policy: {
 }
 ```
 
+### A-1. 무료 주 30회
+
+```ts
+policy: {
+  usageByTier: {
+    FREE: { limit: 30, reset: 'weekly' },
+  },
+}
+```
+
 ### B. 무료 무제한 + 일부 기능 제한
 
 ```ts
@@ -297,7 +310,8 @@ policy: {
 ## 7) 기존 controller.ts 마이그레이션 팁
 
 - 기존 `StatusManager` 인터페이스를 즉시 제거하지 말고, 1차로 호환 어댑터를 두세요.
-- `decrementUsageCount`는 내부적으로 `consume-usage` 또는 `incrementUsage`로 연결하세요.
+- `decrementUsageCount`는 내부적으로 `consumeUsage` 또는 `consume-usage`로 연결하세요.
+  기존 `incrementUsage`는 호환용 저수준 API로만 남기고 새 기능에서는 사용하지 마세요.
 - UI에서 `usageCount`만 보던 경우, 앞으로는 `remainingUsage` + `usageReset` 조합으로 표기하세요.
 
 ## 8) 운영 체크리스트
@@ -313,3 +327,5 @@ policy: {
 - 라이브러리 변경은 Changeset으로 `figma-license-core`와 `figma-ui` 버전을 함께 올린 뒤 패키지를 배포합니다.
 - 플러그인은 테스트 단계에서 새 버전을 정확히 고정하고, Face Dummy에서 활성·만료·철회·요청 제한·네트워크 실패를 확인한 다음 다른 플러그인으로 확장합니다.
 - 운영 플러그인에 `masterCode`를 넣지 않고, WordPress 서버를 권한의 최종 원천으로 유지합니다.
+- 무료 한도와 차단 기능은 각 플러그인의 임의 상태 관리자가 아니라 `figma-license-core`의
+  `policy.usageByTier`와 `policy.featuresByTier`에서 선언합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@designbasekorea/figma-license-core",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Figma plugin license core and status manager for reusable license workflows",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -21,12 +21,12 @@
   "devDependencies": {
     "@rollup/plugin-commonjs": "^25.0.4",
     "@rollup/plugin-node-resolve": "^15.2.1",
-    "@rollup/plugin-typescript": "^11.1.3",
+    "@rollup/plugin-typescript": "^12.3.0",
     "@types/jest": "^29.5.5",
     "jest": "^29.6.4",
     "jest-environment-jsdom": "^29.6.4",
     "rimraf": "^5.0.1",
-    "rollup": "^3.29.2",
+    "rollup": "^4.63.1",
     "typescript": "^5.2.2"
   },
   "publishConfig": {