@designbasekorea/figma-license-core 0.1.0

package/README.md

@@ -0,0 +1,59 @@
+# @designbasekorea/figma-license-core
+
+Figma 플러그인의 라이선스 검증/비활성화/상태 동기화를 공통으로 처리하는 패키지입니다.
+
+## 핵심 포인트
+
+- `LicenseCore`: 순수 로직 (상태, 검증, 에러 매핑, 활성화 제한 판별)
+- `FigmaStorageAdapter` / `FigmaNotifierAdapter`: Figma 전용 어댑터
+- `FigmaLicenseStatusManager`: `initialize`, `verify-license`, `deactivate-license` 메시지 처리
+- `LicenseConfig` 주입 방식으로 플러그인별 하드코딩 제거
+
+## 빠른 시작
+
+```ts
+import { createFigmaLicenseStatusManager } from '@designbasekorea/figma-license-core';
+
+const statusManager = createFigmaLicenseStatusManager({
+  config: {
+    productId: 'my-plugin',
+    endpoint: 'https://api.example.com/license/verify',
+    deactivateEndpoint: 'https://api.example.com/license/deactivate',
+    instanceName: figma.root?.name || 'figma-plugin',
+    usageLimit: 20,
+    storagePrefix: 'my-plugin-license',
+  },
+});
+
+statusManager.bindToOnMessage(async (msg) => {
+  if ((msg as { type?: string }).type === 'process') {
+    // 기존 플러그인 로직
+  }
+});
+
+await statusManager.initialize();
+```
+
+## UI 이벤트 계약
+
+### UI -> Main
+
+- `initialize`
+- `verify-license` (`licenseKey` 포함)
+- `deactivate-license`
+
+### Main -> UI
+
+- `update-plugin-status`
+- `license-verification-result`
+- `license-deactivation-result`
+
+에러는 `errorCode` 값으로 전달됩니다.
+
+- `ACTIVATION_LIMIT_REACHED`
+- `INVALID_LICENSE`
+- `PRODUCT_MISMATCH`
+- `NETWORK_ERROR`
+- `STORAGE_ERROR`
+- `SERVER_ERROR`
+- `UNKNOWN_ERROR`

package/dist/fetchLicenseTransport.d.ts

@@ -0,0 +1,23 @@
+import { DeactivateLicensePayload, DeactivateLicenseResult, LicenseTransport, VerifyLicensePayload, VerifyLicenseResult } from './types';
+export declare function defaultNormalizeVerifyResponse(raw: unknown): VerifyLicenseResult;
+export declare function defaultNormalizeDeactivateResponse(raw: unknown): DeactivateLicenseResult;
+export interface FetchLicenseTransportConfig {
+    verifyUrl: string;
+    deactivateUrl?: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    fetchFn?: typeof fetch;
+    buildVerifyBody?: (payload: VerifyLicensePayload) => unknown;
+    buildDeactivateBody?: (payload: DeactivateLicensePayload) => unknown;
+    normalizeVerifyResponse?: (raw: unknown) => VerifyLicenseResult;
+    normalizeDeactivateResponse?: (raw: unknown) => DeactivateLicenseResult;
+}
+export declare class FetchLicenseTransport implements LicenseTransport {
+    private readonly config;
+    private readonly fetchFn;
+    constructor(config: FetchLicenseTransportConfig);
+    verify(payload: VerifyLicensePayload): Promise<VerifyLicenseResult>;
+    deactivate(payload: DeactivateLicensePayload): Promise<DeactivateLicenseResult>;
+    private postJson;
+}
+//# sourceMappingURL=fetchLicenseTransport.d.ts.map

package/dist/fetchLicenseTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchLicenseTransport.d.ts","sourceRoot":"","sources":["../src/fetchLicenseTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AA4CjB,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAmChF;AAED,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,OAAO,GAAG,uBAAuB,CAexF;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC;IAC7D,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC;IACrE,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,mBAAmB,CAAC;IAChE,2BAA2B,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,uBAAuB,CAAC;CACzE;AAED,qBAAa,qBAAsB,YAAW,gBAAgB;IAGhD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAEV,MAAM,EAAE,2BAA2B;IAQ1D,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUnE,UAAU,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;YAevE,QAAQ;CA8BvB"}

package/dist/figmaStatusManager.d.ts

@@ -0,0 +1,69 @@
+import { LicenseCore } from './licenseCore';
+import { LicenseConfig, LicenseManagerMessageTypes, LicenseNotifierAdapter, LicenseStorageAdapter, LicenseTransport } from './types';
+export interface FigmaClientStorageLike {
+    getAsync(key: string): Promise<unknown>;
+    setAsync(key: string, value: unknown): Promise<void>;
+    deleteAsync?(key: string): Promise<void>;
+}
+export interface FigmaUiLike {
+    postMessage(message: unknown): void;
+    onmessage?: (pluginMessage: unknown) => void | Promise<void>;
+}
+export interface FigmaApiLike {
+    clientStorage: FigmaClientStorageLike;
+    ui: FigmaUiLike;
+    notify?: (message: string, options?: {
+        error?: boolean;
+        timeout?: number;
+    }) => void;
+}
+export declare class FigmaStorageAdapter implements LicenseStorageAdapter {
+    private readonly figma;
+    constructor(figma: FigmaApiLike);
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    set<T = unknown>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+export declare class FigmaNotifierAdapter implements LicenseNotifierAdapter {
+    private readonly figma;
+    constructor(figma: FigmaApiLike);
+    notify(message: string, options?: {
+        error?: boolean;
+        timeout?: number;
+    }): void;
+}
+export interface FigmaLicenseStatusManagerOptions {
+    figma: FigmaApiLike;
+    core: LicenseCore;
+    notifier?: LicenseNotifierAdapter;
+    messageTypes?: Partial<LicenseManagerMessageTypes>;
+}
+export interface FigmaLicenseMessage {
+    type: string;
+    [key: string]: unknown;
+}
+export declare class FigmaLicenseStatusManager {
+    private readonly options;
+    private readonly messageTypes;
+    private readonly notifier?;
+    constructor(options: FigmaLicenseStatusManagerOptions);
+    initialize(): Promise<void>;
+    handleMessage(pluginMessage: unknown): Promise<boolean>;
+    bindToOnMessage(fallbackHandler?: (pluginMessage: unknown) => void | Promise<void>): void;
+    private handleVerifyLicense;
+    private handleDeactivateLicense;
+    private postStatusUpdate;
+    private postMessage;
+    private notifyError;
+}
+export interface CreateFigmaLicenseStatusManagerOptions {
+    config: LicenseConfig;
+    figma?: FigmaApiLike;
+    transport?: LicenseTransport;
+    storage?: LicenseStorageAdapter;
+    notifier?: LicenseNotifierAdapter;
+    messageTypes?: Partial<LicenseManagerMessageTypes>;
+    fetchFn?: typeof fetch;
+}
+export declare function createFigmaLicenseStatusManager(options: CreateFigmaLicenseStatusManagerOptions): FigmaLicenseStatusManager;
+//# sourceMappingURL=figmaStatusManager.d.ts.map

package/dist/figmaStatusManager.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './licenseErrorMapper';
+export * from './licenseCore';
+export * from './fetchLicenseTransport';
+export * from './figmaStatusManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}