@designbasekorea/figma-license-core 0.2.1 → 0.3.1

package/README.md

@@ -8,7 +8,7 @@ Figma 플러그인의 라이선스 상태/사용량 정책/기능 제한을 공
   - `hasLicenseKey`: 라이선스 키가 저장되어 있는지
   - `isLicenseRegistered`: 실제 유효 등록(PAID + key) 상태인지
 - 티어별 사용량 정책
-  - 일간 리셋 (`daily`), 월간 리셋 (`monthly`), 리셋 없음 (`none`)
+- 일간 리셋 (`daily`), 주간 리셋 (`weekly`), 월간 리셋 (`monthly`), 리셋 없음 (`none`)
   - `limit: number | 'unlimited'`
 - 티어별 기능 제한
   - `allow`/`deny` 기반 기능 접근 제어
@@ -65,6 +65,32 @@ await statusManager.initialize();
 - `check-feature-access` (`featureKey` 선택)
 - `consume-usage` (`amount`, `featureKey` 선택)
 
+`amount`가 남은 수량보다 크면 소비되지 않습니다. 마지막 1회를 소비한 응답도
+`success: true`, `remaining: 0`으로 반환되므로 실행 성공 여부와 다음 차단 상태를 혼동하지 않습니다.
+
+## 플러그인 공통 사용 규칙
+
+모든 플러그인은 기능 실행 직전에 같은 순서를 사용합니다.
+
+```ts
+const access = await statusManager.canUseFeature('bulk_apply', 1);
+if (!access.allowed) {
+  // access.reason === 'FEATURE_NOT_ALLOWED' 또는 'USAGE_LIMIT_REACHED'
+  return;
+}
+
+const result = await statusManager.consumeUsage(1, 'bulk_apply');
+if (!result.consumed) {
+  return;
+}
+
+await runBulkApply();
+```
+
+UI 메시지를 사용하는 경우에는 `check-feature-access`로 미리 확인한 뒤
+`consume-usage`를 실행 직전에 전송합니다. 서버에서 최종 권한을 판정하는 제품은
+동일한 feature key를 서버와 코어 설정에 사용해야 합니다.
+
 ### Main -> UI
 
 - `update-plugin-status`
@@ -88,6 +114,8 @@ await statusManager.initialize();
 - 운영 배포에서는 `masterCode`를 사용하지 마세요.
 - 최종 권한 판정은 서버 검증 결과 기준으로 처리하세요.
 - 클라이언트 상태(`paymentStatus`, `usageCount`)는 변조 가능하다고 가정하세요.
+- 모든 플러그인의 리셋 단위·무료 한도·차단 기능은 `policy`에서만 선언하고,
+  플러그인별 임의 카운터를 추가하지 마세요.
 
 ## 문서
 

package/dist/figmaStatusManager.d.ts

@@ -32,6 +32,7 @@ export declare class FigmaNotifierAdapter implements LicenseNotifierAdapter {
         timeout?: number;
     }): void;
 }
+export declare const DEFAULT_LICENSE_MESSAGE_TYPES: Required<LicenseManagerMessageTypes>;
 export interface FigmaLicenseStatusManagerOptions {
     figma: FigmaApiLike;
     core: LicenseCore;
@@ -46,13 +47,20 @@ export declare class FigmaLicenseStatusManager {
     private readonly options;
     private readonly messageTypes;
     private readonly notifier?;
-    private readonly featureAccessMessageType;
-    private readonly consumeUsageMessageType;
     private initializationPromise?;
     constructor(options: FigmaLicenseStatusManagerOptions);
     initialize(): Promise<void>;
     handleMessage(pluginMessage: unknown): Promise<boolean>;
     bindToOnMessage(fallbackHandler?: (pluginMessage: unknown) => void | Promise<void>): void;
+    /**
+     * Check a feature from main code using the same policy as the UI messages.
+     * This is the preferred guard for operations handled entirely in main.
+     */
+    canUseFeature(featureKey?: string, amount?: number): Promise<import("./types").UsageAccessResult>;
+    /**
+     * Consume usage from main code and publish the refreshed status to the UI.
+     */
+    consumeUsage(amount?: number, featureKey?: string): Promise<import("./types").UsageConsumptionResult>;
     private handleVerifyLicense;
     private handleDeactivateLicense;
     private postStatusUpdate;

package/dist/figmaStatusManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figmaStatusManager.d.ts","sourceRoot":"","sources":["../src/figmaStatusManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"figmaStatusManager.d.ts","sourceRoot":"","sources":["../src/figmaStatusManager.ts"],"names":[],"mappings":"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"}

package/dist/index.esm.js

@@ -122,6 +122,7 @@ const STORAGE_KEYS = {
     activationUsage: 'activationUsage',
     usageCount: 'usageCount',
     previousUsageCount: 'previousUsageCount',
+    previousUsageWindowKey: 'previousUsageWindowKey',
     usageWindowKey: 'usageWindowKey',
     planTier: 'planTier',
     lastVerifiedAt: 'lastVerifiedAt',
@@ -186,7 +187,7 @@ function normalizeTier(tier) {
     return tier.trim() || 'FREE';
 }
 function normalizeUsageReset(reset) {
-    if (reset === 'daily' || reset === 'monthly' || reset === 'none') {
+    if (reset === 'daily' || reset === 'weekly' || reset === 'monthly' || reset === 'none') {
         return reset;
     }
     return 'none';
@@ -201,6 +202,19 @@ function toDateKey(date, period) {
     if (period === 'monthly') {
         return `${year}-${month}`;
     }
+    if (period === 'weekly') {
+        // ISO weeks start on Monday and keep the week-year at the Thursday of
+        // the current week. Using UTC avoids a reset moving at local DST changes.
+        const dayOfWeek = date.getUTCDay() || 7;
+        const thursday = new Date(Date.UTC(year, date.getUTCMonth(), date.getUTCDate()));
+        thursday.setUTCDate(thursday.getUTCDate() + (4 - dayOfWeek));
+        const weekYear = thursday.getUTCFullYear();
+        const firstThursday = new Date(Date.UTC(weekYear, 0, 4));
+        const firstDay = firstThursday.getUTCDay() || 7;
+        firstThursday.setUTCDate(firstThursday.getUTCDate() + (4 - firstDay));
+        const week = 1 + Math.round((thursday.getTime() - firstThursday.getTime()) / 604800000);
+        return `${weekYear}-W${String(week).padStart(2, '0')}`;
+    }
     return `${year}-${month}-${day}`;
 }
 function normalizePolicy(config) {
@@ -239,6 +253,7 @@ class LicenseCore {
     constructor(config, deps) {
         this.config = config;
         this.deps = deps;
+        this.usageMutation = Promise.resolve();
         if (!config.productId.trim()) {
             throw new Error('LicenseConfig.productId is required.');
         }
@@ -283,13 +298,15 @@ class LicenseCore {
     }
     async resetLicenseState() {
         const current = await this.getStatus();
-        const freeReset = this.getUsagePolicy(this.policy.freeTier).reset;
         const previousUsageCount = current.previousUsageCount ?? 0;
+        const previousUsageWindowKey = current.previousUsageWindowKey || '';
         const nextState = {
             ...current,
             paymentStatus: 'FREE',
             planTier: this.policy.freeTier,
-            usageWindowKey: toDateKey(new Date(), freeReset),
+            // 유료 전환 전에 사용하던 무료 사용량 창을 복원한다. 날짜가 바뀌었다면
+            // applyUsageWindowResetIfNeeded()가 아래 카운트를 0으로 초기화한다.
+            usageWindowKey: previousUsageWindowKey,
             licenseKey: '',
             instanceId: '',
             activationLimit: 0,
@@ -309,6 +326,7 @@ class LicenseCore {
         const nextState = {
             ...current,
             paymentStatus: 'PAID',
+            planTier: normalizeTier(result.planTier || current.planTier || this.policy.paidTier),
             activationLimit: result.activationLimit ?? current.activationLimit,
             activationUsage: result.activationUsage ?? current.activationUsage,
             licenseStatus: result.licenseStatus || 'active',
@@ -322,12 +340,12 @@ class LicenseCore {
         return nextState;
     }
     async markValidationFailure(current, message, errorCode) {
-        const freeReset = this.getUsagePolicy(this.policy.freeTier).reset;
+        const previousUsageWindowKey = current.previousUsageWindowKey || '';
         const nextState = {
             ...current,
             paymentStatus: 'UNPAID',
             planTier: this.policy.freeTier,
-            usageWindowKey: toDateKey(new Date(), freeReset),
+            usageWindowKey: previousUsageWindowKey,
             activationLimit: 0,
             activationUsage: 0,
             usageCount: current.previousUsageCount ?? current.usageCount,
@@ -377,6 +395,7 @@ class LicenseCore {
                 activationLimit: MASTER_CODE_ACTIVATION_LIMIT,
                 activationUsage: 0,
                 previousUsageCount: current.usageCount,
+                previousUsageWindowKey: current.usageWindowKey,
                 lastVerifiedAt: new Date().toISOString(),
                 licenseStatus: 'active',
                 licenseSource: 'master',
@@ -424,6 +443,7 @@ class LicenseCore {
             activationLimit,
             activationUsage,
             previousUsageCount: current.usageCount,
+            previousUsageWindowKey: current.usageWindowKey,
             lastVerifiedAt: new Date().toISOString(),
             licenseStatus: verifyResult.licenseStatus || 'active',
             licenseSource: verifyResult.licenseSource,
@@ -466,7 +486,7 @@ class LicenseCore {
         if (current.paymentStatus === 'PAID') {
             return current;
         }
-        const increasedAmount = Math.max(0, amount);
+        const increasedAmount = Number.isFinite(amount) ? Math.max(0, amount) : 0;
         if (increasedAmount === 0) {
             return current;
         }
@@ -477,28 +497,39 @@ class LicenseCore {
         await this.persistState(nextState);
         return nextState;
     }
-    async canUseFeature(featureKey) {
+    async canUseFeature(featureKey, amount = 1) {
         const state = await this.getStatus();
-        return this.resolveUsageAccess(state, featureKey);
+        return this.resolveUsageAccess(state, featureKey, amount);
     }
     async consumeUsage(amount = 1, featureKey) {
-        const state = await this.getStatus();
-        const access = this.resolveUsageAccess(state, featureKey);
-        if (!access.allowed || amount <= 0) {
-            return { state, access };
-        }
-        const updatedState = await this.incrementUsage(amount);
-        const updatedAccess = this.resolveUsageAccess(updatedState, featureKey);
-        return {
-            state: updatedState,
-            access: updatedAccess,
+        const execute = async () => {
+            const state = await this.getStatus();
+            const requestedAmount = Number.isFinite(amount) ? Math.max(0, amount) : 0;
+            const access = this.resolveUsageAccess(state, featureKey, requestedAmount);
+            if (!access.allowed || requestedAmount <= 0) {
+                return { state, access, consumed: false };
+            }
+            const updatedState = await this.incrementUsage(requestedAmount);
+            const updatedAccess = this.resolveUsageAccess(updatedState, featureKey, requestedAmount);
+            return {
+                state: updatedState,
+                access: updatedAccess,
+                consumed: true,
+            };
         };
-    }
-    resolveUsageAccess(state, featureKey) {
+        // Figma can deliver duplicate UI events while a panel remounts. Serialize
+        // the check + persist pair so two concurrent requests cannot overspend the
+        // same local allowance.
+        const pending = this.usageMutation.then(execute, execute);
+        this.usageMutation = pending.then(() => undefined, () => undefined);
+        return pending;
+    }
+    resolveUsageAccess(state, featureKey, amount = 1) {
         const tier = this.resolveTier(state);
         const usagePolicy = this.getUsagePolicy(tier);
         const featureAllowed = this.isFeatureAllowed(tier, featureKey);
         const isLicensed = this.isLicenseRegisteredState(state);
+        const requested = Number.isFinite(amount) && amount > 0 ? amount : 1;
         const used = state.usageCount;
         if (usagePolicy.limit === 'unlimited') {
             return {
@@ -507,6 +538,7 @@ class LicenseCore {
                 used,
                 limit: 'unlimited',
                 reset: usagePolicy.reset,
+                requested,
                 tier,
                 hasLicenseKey: Boolean(state.licenseKey),
                 isLicenseRegistered: isLicensed,
@@ -516,7 +548,7 @@ class LicenseCore {
             };
         }
         const remaining = Math.max(usagePolicy.limit - used, 0);
-        const usageAllowed = remaining > 0;
+        const usageAllowed = remaining >= requested;
         const allowed = featureAllowed && usageAllowed;
         return {
             allowed,
@@ -524,6 +556,7 @@ class LicenseCore {
             used,
             limit: usagePolicy.limit,
             reset: usagePolicy.reset,
+            requested,
             tier,
             hasLicenseKey: Boolean(state.licenseKey),
             isLicenseRegistered: isLicensed,
@@ -532,19 +565,18 @@ class LicenseCore {
             reason: featureAllowed ? (usageAllowed ? undefined : 'USAGE_LIMIT_REACHED') : 'FEATURE_NOT_ALLOWED',
         };
     }
-    getUsageLimit() {
-        const freePolicy = this.getUsagePolicy(this.policy.freeTier);
-        return freePolicy.limit === 'unlimited' ? Number.POSITIVE_INFINITY : freePolicy.limit;
+    getUsageLimit(state) {
+        const tier = state ? this.resolveTier(state) : this.policy.freeTier;
+        return this.getUsagePolicy(tier).limit;
     }
     getStoragePrefix() {
         return this.storagePrefix;
     }
     resolveTier(state) {
         const storedTier = normalizeTier(state.planTier || '');
-        if (storedTier) {
+        {
             return storedTier;
         }
-        return state.paymentStatus === 'PAID' ? this.policy.paidTier : this.policy.freeTier;
     }
     getUsagePolicy(tier) {
         return this.policy.usageByTier[tier]
@@ -579,7 +611,7 @@ class LicenseCore {
     }
     async loadState() {
         try {
-            const [paymentStatus, licenseKey, instanceId, activationLimit, activationUsage, usageCount, previousUsageCount, usageWindowKey, planTier, lastVerifiedAt, licenseStatus, licenseSource, accessScope, expiresAt, validationMessage,] = await Promise.all([
+            const [paymentStatus, licenseKey, instanceId, activationLimit, activationUsage, usageCount, previousUsageCount, previousUsageWindowKey, usageWindowKey, planTier, lastVerifiedAt, licenseStatus, licenseSource, accessScope, expiresAt, validationMessage,] = await Promise.all([
                 this.deps.storage.get(this.storageKey('paymentStatus')),
                 this.deps.storage.get(this.storageKey('licenseKey')),
                 this.deps.storage.get(this.storageKey('instanceId')),
@@ -587,6 +619,7 @@ class LicenseCore {
                 this.deps.storage.get(this.storageKey('activationUsage')),
                 this.deps.storage.get(this.storageKey('usageCount')),
                 this.deps.storage.get(this.storageKey('previousUsageCount')),
+                this.deps.storage.get(this.storageKey('previousUsageWindowKey')),
                 this.deps.storage.get(this.storageKey('usageWindowKey')),
                 this.deps.storage.get(this.storageKey('planTier')),
                 this.deps.storage.get(this.storageKey('lastVerifiedAt')),
@@ -608,6 +641,7 @@ class LicenseCore {
                 activationUsage: toNonNegativeNumber(activationUsage, 0),
                 usageCount: toNonNegativeNumber(usageCount, 0),
                 previousUsageCount: toNonNegativeNumber(previousUsageCount, 0),
+                previousUsageWindowKey: toText(previousUsageWindowKey) || undefined,
                 usageWindowKey: toText(usageWindowKey) || toDateKey(new Date(), usageReset),
                 planTier: resolvedTier,
                 lastVerifiedAt: toText(lastVerifiedAt) || undefined,
@@ -649,6 +683,7 @@ class LicenseCore {
                 this.deps.storage.set(this.storageKey('activationUsage'), state.activationUsage),
                 this.deps.storage.set(this.storageKey('usageCount'), state.usageCount),
                 this.deps.storage.set(this.storageKey('previousUsageCount'), state.previousUsageCount || 0),
+                this.deps.storage.set(this.storageKey('previousUsageWindowKey'), state.previousUsageWindowKey || ''),
                 this.deps.storage.set(this.storageKey('usageWindowKey'), state.usageWindowKey),
                 this.deps.storage.set(this.storageKey('planTier'), state.planTier),
                 this.deps.storage.set(this.storageKey('lastVerifiedAt'), state.lastVerifiedAt || ''),
@@ -1121,21 +1156,23 @@ class FigmaNotifierAdapter {
         }
     }
 }
-const DEFAULT_MESSAGE_TYPES = {
+const DEFAULT_LICENSE_MESSAGE_TYPES = {
     initialize: 'initialize',
     verifyLicense: 'verify-license',
     deactivateLicense: 'deactivate-license',
     updateStatus: 'update-plugin-status',
     verifyResult: 'license-verification-result',
     deactivateResult: 'license-deactivation-result',
+    checkFeatureAccess: 'check-feature-access',
+    consumeUsage: 'consume-usage',
+    featureAccessResult: 'feature-access-result',
+    usageConsumeResult: 'usage-consume-result',
 };
 class FigmaLicenseStatusManager {
     constructor(options) {
         this.options = options;
-        this.featureAccessMessageType = 'feature-access-result';
-        this.consumeUsageMessageType = 'usage-consume-result';
         this.messageTypes = {
-            ...DEFAULT_MESSAGE_TYPES,
+            ...DEFAULT_LICENSE_MESSAGE_TYPES,
             ...(options.messageTypes || {}),
         };
         this.notifier = options.notifier;
@@ -1174,13 +1211,18 @@ class FigmaLicenseStatusManager {
             await this.handleDeactivateLicense();
             return true;
         }
-        if (type === 'check-feature-access') {
+        if (type === this.messageTypes.checkFeatureAccess) {
             const featureKey = typeof message.featureKey === 'string' ? message.featureKey : undefined;
-            await this.handleCheckFeatureAccess(featureKey);
+            const amount = typeof message.amount === 'number' && Number.isFinite(message.amount) && message.amount > 0
+                ? message.amount
+                : 1;
+            await this.handleCheckFeatureAccess(featureKey, amount);
             return true;
         }
-        if (type === 'consume-usage') {
-            const amount = typeof message.amount === 'number' ? message.amount : 1;
+        if (type === this.messageTypes.consumeUsage) {
+            const amount = typeof message.amount === 'number' && Number.isFinite(message.amount) && message.amount > 0
+                ? message.amount
+                : 1;
             const featureKey = typeof message.featureKey === 'string' ? message.featureKey : undefined;
             await this.handleConsumeUsage(amount, featureKey);
             return true;
@@ -1196,6 +1238,23 @@ class FigmaLicenseStatusManager {
             }
         };
     }
+    /**
+     * Check a feature from main code using the same policy as the UI messages.
+     * This is the preferred guard for operations handled entirely in main.
+     */
+    async canUseFeature(featureKey, amount = 1) {
+        const state = await this.options.core.getStatus();
+        const safeAmount = Number.isFinite(amount) && amount > 0 ? amount : 1;
+        return this.options.core.resolveUsageAccess(state, featureKey, safeAmount);
+    }
+    /**
+     * Consume usage from main code and publish the refreshed status to the UI.
+     */
+    async consumeUsage(amount = 1, featureKey) {
+        const result = await this.options.core.consumeUsage(amount, featureKey);
+        await this.postStatusUpdate(result.state);
+        return result;
+    }
     async handleVerifyLicense(licenseKey) {
         try {
             const state = await this.options.core.verifyLicense(licenseKey);
@@ -1207,7 +1266,7 @@ class FigmaLicenseStatusManager {
                 message: '라이선스가 검증되었습니다.',
                 ...state,
                 ...summary,
-                usageLimit: this.options.core.getUsageLimit(),
+                usageLimit: this.options.core.getUsageLimit(state),
                 canUseFeature: access.allowed,
                 remainingUsage: access.remaining,
                 usageUsed: access.used,
@@ -1239,7 +1298,7 @@ class FigmaLicenseStatusManager {
                 message: '라이선스가 비활성화되었습니다.',
                 ...state,
                 ...summary,
-                usageLimit: this.options.core.getUsageLimit(),
+                usageLimit: this.options.core.getUsageLimit(state),
                 canUseFeature: access.allowed,
                 remainingUsage: access.remaining,
                 usageUsed: access.used,
@@ -1267,7 +1326,7 @@ class FigmaLicenseStatusManager {
             type: this.messageTypes.updateStatus,
             ...state,
             ...summary,
-            usageLimit: this.options.core.getUsageLimit(),
+            usageLimit: this.options.core.getUsageLimit(state),
             canUseFeature: access.allowed,
             remainingUsage: access.remaining,
             usageUsed: access.used,
@@ -1276,14 +1335,15 @@ class FigmaLicenseStatusManager {
             usageReason: access.reason,
         });
     }
-    async handleCheckFeatureAccess(featureKey) {
+    async handleCheckFeatureAccess(featureKey, amount = 1) {
         const state = await this.options.core.getStatus();
-        const access = this.options.core.resolveUsageAccess(state, featureKey);
+        const access = this.options.core.resolveUsageAccess(state, featureKey, amount);
         const summary = await this.options.core.getLicenseSummary();
         this.postMessage({
-            type: this.featureAccessMessageType,
+            type: this.messageTypes.featureAccessResult,
             success: true,
             featureKey,
+            amount,
             ...summary,
             ...access,
         });
@@ -1292,10 +1352,11 @@ class FigmaLicenseStatusManager {
         const result = await this.options.core.consumeUsage(amount, featureKey);
         const summary = await this.options.core.getLicenseSummary();
         this.postMessage({
-            type: this.consumeUsageMessageType,
-            success: result.access.allowed,
+            type: this.messageTypes.usageConsumeResult,
+            success: result.consumed,
             featureKey,
             amount,
+            consumed: result.consumed,
             ...summary,
             ...result.access,
             usageCount: result.state.usageCount,
@@ -1348,5 +1409,5 @@ function createFigmaLicenseStatusManager(options) {
     });
 }
 
-export { DesignbaseAccountAuthClient, DesignbaseAccountLicenseTransport, FetchLicenseTransport, FigmaLicenseStatusManager, FigmaNotifierAdapter, FigmaStorageAdapter, LicenseCore, LicenseCoreError, LicenseErrorCode, LicenseTransportHttpError, createFigmaLicenseStatusManager, defaultNormalizeDeactivateResponse, defaultNormalizeVerifyResponse, isActivationLimitReached, mapLicenseError };
+export { DEFAULT_LICENSE_MESSAGE_TYPES, DesignbaseAccountAuthClient, DesignbaseAccountLicenseTransport, FetchLicenseTransport, FigmaLicenseStatusManager, FigmaNotifierAdapter, FigmaStorageAdapter, LicenseCore, LicenseCoreError, LicenseErrorCode, LicenseTransportHttpError, createFigmaLicenseStatusManager, defaultNormalizeDeactivateResponse, defaultNormalizeVerifyResponse, isActivationLimitReached, mapLicenseError };
 //# sourceMappingURL=index.esm.js.map