@framingui/mcp-server 0.6.26 → 0.6.28

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server for building production UI through FramingUI.
 
-`@framingui/mcp-server` gives AI coding agents a real UI contract: components, themes, layout tokens, templates, validation, and environment checks.
+`@framingui/mcp-server` gives AI coding agents a real UI contract: components, themes, layout tokens, validated workflows, quota visibility, and environment checks.
 
 ## Install
 
@@ -24,6 +24,8 @@ Authenticate:
 npx -y @framingui/mcp-server@latest login
 ```
 
+`whoami` now also returns a shadow quota snapshot so teams can inspect weighted tool-unit usage before usage-based billing is enforced.
+
 ## CLI Commands
 
 ```bash
@@ -115,8 +117,7 @@ FramingUI exposes guidance for:
 `init` can:
 
 - install the FramingUI screen-generation runtime and peer dependencies in one pass
-- install `tailwindcss-animate`
-- configure Tailwind content paths for Tailwind v3 projects
+- configure Tailwind content paths and `tailwindcss-animate`
 - add `@import '@framingui/ui/styles';` to a detected global stylesheet
 - generate a local `framingui-theme` module
 - wire `FramingUIProvider` into `app/layout.tsx` or `src/main.tsx`

package/dist/__tests__/react-native-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=react-native-contract.test.d.ts.map

package/dist/__tests__/react-native-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/react-native-contract.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/react-native-contract.test.js

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+import { getPlatformSupportInfo, getImportStatementForPlatform, getReactNativeAuditRules, getSupportedPlatforms, } from '../platform-support.js';
+import { GetScreenGenerationContextInputSchema, ListComponentsInputSchema, PreviewComponentInputSchema, ValidateEnvironmentInputSchema, } from '../schemas/mcp-schemas.js';
+describe('React Native direct-write contract', () => {
+    it('exposes web and react-native platform targets', () => {
+        expect(getSupportedPlatforms()).toEqual(['web', 'react-native']);
+    });
+    it('marks primitive components as recommended for react-native direct write', () => {
+        const info = getPlatformSupportInfo('Button', 'react-native');
+        expect(info.supported).toBe(true);
+        expect(info.recommended).toBe(true);
+        expect(info.status).toBe('full');
+        expect(info.recommendedImports).toContain('@framingui/react-native');
+        expect(info.recommendedPackages).toContain('@framingui/react-native');
+    });
+    it('returns runtime package imports for primitives with extracted native exports', () => {
+        expect(getImportStatementForPlatform('Button', 'react-native')).toBe("import { Button } from '@framingui/react-native';");
+        expect(getImportStatementForPlatform('Input', 'react-native')).toBe("import { TextField } from '@framingui/react-native';");
+    });
+    it('marks web-centric components as avoid for react-native direct write', () => {
+        const info = getPlatformSupportInfo('Table', 'react-native');
+        expect(info.supported).toBe(false);
+        expect(info.status).toBe('avoid');
+        expect(info.notes[0]).toContain('web-only');
+    });
+    it('defines react-native audit rules for direct-write qc', () => {
+        const rules = getReactNativeAuditRules();
+        expect(rules.map(rule => rule.id)).toEqual([
+            'rn-hardcoded-color',
+            'rn-hardcoded-spacing',
+            'rn-web-classname',
+        ]);
+    });
+    it('accepts react-native as a schema input target', () => {
+        expect(ListComponentsInputSchema.parse({ platform: 'react-native' }).platform).toBe('react-native');
+        expect(PreviewComponentInputSchema.parse({ componentId: 'button', platform: 'react-native' })
+            .platform).toBe('react-native');
+        expect(GetScreenGenerationContextInputSchema.parse({
+            description: 'profile screen',
+            platform: 'react-native',
+        }).platform).toBe('react-native');
+        expect(ValidateEnvironmentInputSchema.parse({
+            projectPath: '/tmp/project',
+            requiredPackages: [],
+            platform: 'react-native',
+            sourceFiles: ['/tmp/App.tsx'],
+        }).platform).toBe('react-native');
+    });
+});
+//# sourceMappingURL=react-native-contract.test.js.map

package/dist/__tests__/react-native-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-contract.test.js","sourceRoot":"","sources":["../../src/__tests__/react-native-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,qCAAqC,EACrC,yBAAyB,EACzB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAE9D,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACrE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,CAAC,6BAA6B,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAClE,mDAAmD,CACpD,CAAC;QACF,MAAM,CAAC,6BAA6B,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CACjE,sDAAsD,CACvD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAE7D,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,KAAK,GAAG,wBAAwB,EAAE,CAAC;QAEzC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACzC,oBAAoB;YACpB,sBAAsB;YACtB,kBAAkB;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CACjF,cAAc,CACf,CAAC;QACF,MAAM,CACJ,2BAA2B,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;aACnF,QAAQ,CACZ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvB,MAAM,CACJ,qCAAqC,CAAC,KAAK,CAAC;YAC1C,WAAW,EAAE,gBAAgB;YAC7B,QAAQ,EAAE,cAAc;SACzB,CAAC,CAAC,QAAQ,CACZ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvB,MAAM,CACJ,8BAA8B,CAAC,KAAK,CAAC;YACnC,WAAW,EAAE,cAAc;YAC3B,gBAAgB,EAAE,EAAE;YACpB,QAAQ,EAAE,cAAc;YACxB,WAAW,EAAE,CAAC,cAAc,CAAC;SAC9B,CAAC,CAAC,QAAQ,CACZ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/auth/state.d.ts

@@ -3,6 +3,16 @@
  * SPEC-DEPLOY-001 Phase 4.1: MCP Server Authentication Layer
  */
 import type { VerifyResponse } from './verify.js';
+import { MemoryCache } from './cache.js';
+interface FraminguiAuthState {
+    authCache: MemoryCache<VerifyResponse>;
+    currentAuthData: VerifyResponse | null;
+    authStateExplicitlySet: boolean;
+    rawApiKey: string | null;
+}
+declare global {
+    var __framinguiAuthState: FraminguiAuthState | undefined;
+}
 /**
  * Set authentication data and cache it
  * @param authData - Verification response from API
@@ -13,6 +23,11 @@ export declare function setAuthData(authData: VerifyResponse | null): void;
  * @returns Current authentication data or null if not authenticated
  */
 export declare function getAuthData(): VerifyResponse | null;
+/**
+ * Whether auth state was explicitly injected via login/verify/test helpers.
+ * When false, the server is operating on credential-file fallback only.
+ */
+export declare function isAuthStateExplicitlySet(): boolean;
 /**
  * Store raw API key for data-client API calls
  */
@@ -38,4 +53,5 @@ export declare function isAuthenticated(): boolean;
  * @returns Array of accessible theme IDs
  */
 export declare function getAccessibleThemes(allThemeIds: string[]): string[];
+export {};
 //# sourceMappingURL=state.d.ts.map

package/dist/auth/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/auth/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAiBlD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAOjE;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,cAAc,GAAG,IAAI,CAWnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAoBnE"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/auth/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQzC,UAAU,kBAAkB;IAC1B,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACvC,eAAe,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,sBAAsB,EAAE,OAAO,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,oBAAoB,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC1D;AAaD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CASjE;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,cAAc,GAAG,IAAI,CA8BnD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAU5C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAOpC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAoBnE"}

package/dist/auth/state.js

@@ -5,22 +5,28 @@
 import { MemoryCache } from './cache.js';
 import { info } from '../utils/logger.js';
 import { isMasterAccount } from './theme-access.js';
+import { loadCredentials } from '../cli/credentials.js';
 // Cache TTL: 5 minutes (300,000 milliseconds)
 const CACHE_TTL_MS = 5 * 60 * 1000;
-// Global authentication data cache
-const authCache = new MemoryCache();
-// Current authentication state
-let currentAuthData = null;
-// Raw API key (API 데이터 클라이언트에서 Bearer 헤더로 사용)
-let rawApiKey = null;
+function getGlobalAuthState() {
+    globalThis.__framinguiAuthState ??= {
+        authCache: new MemoryCache(),
+        currentAuthData: null,
+        authStateExplicitlySet: false,
+        rawApiKey: null,
+    };
+    return globalThis.__framinguiAuthState;
+}
 /**
  * Set authentication data and cache it
  * @param authData - Verification response from API
  */
 export function setAuthData(authData) {
-    currentAuthData = authData;
+    const state = getGlobalAuthState();
+    state.currentAuthData = authData;
+    state.authStateExplicitlySet = true;
     if (authData && authData.valid) {
-        authCache.set('auth', authData, CACHE_TTL_MS);
+        state.authCache.set('auth', authData, CACHE_TTL_MS);
         info('Authentication data cached for 5 minutes');
     }
 }
@@ -29,34 +35,67 @@ export function setAuthData(authData) {
  * @returns Current authentication data or null if not authenticated
  */
 export function getAuthData() {
+    const state = getGlobalAuthState();
     // Try to get from cache first
-    const cachedAuth = authCache.get('auth');
+    const cachedAuth = state.authCache.get('auth');
     if (cachedAuth) {
         info('Using cached authentication data');
         return cachedAuth;
     }
+    if (!state.authStateExplicitlySet) {
+        const credentials = loadCredentials();
+        if (credentials?.api_key) {
+            state.rawApiKey = state.rawApiKey ?? credentials.api_key;
+            state.currentAuthData = {
+                valid: true,
+                user: {
+                    id: 'credentials-user',
+                    email: credentials.user_email,
+                    plan: 'pro',
+                },
+                themes: { licensed: [] },
+            };
+            return state.currentAuthData;
+        }
+    }
     // Return current state
-    return currentAuthData;
+    return state.currentAuthData;
+}
+/**
+ * Whether auth state was explicitly injected via login/verify/test helpers.
+ * When false, the server is operating on credential-file fallback only.
+ */
+export function isAuthStateExplicitlySet() {
+    return getGlobalAuthState().authStateExplicitlySet;
 }
 /**
  * Store raw API key for data-client API calls
  */
 export function setRawApiKey(apiKey) {
-    rawApiKey = apiKey;
+    getGlobalAuthState().rawApiKey = apiKey;
 }
 /**
  * Get raw API key for data-client API calls
  */
 export function getRawApiKey() {
-    return rawApiKey;
+    const state = getGlobalAuthState();
+    if (!state.rawApiKey) {
+        const credentials = loadCredentials();
+        if (credentials?.api_key) {
+            state.rawApiKey = credentials.api_key;
+        }
+    }
+    return state.rawApiKey;
 }
 /**
  * Clear authentication data and cache
  */
 export function clearAuthData() {
-    currentAuthData = null;
-    rawApiKey = null;
-    authCache.clear();
+    const state = getGlobalAuthState();
+    state.currentAuthData = null;
+    state.rawApiKey = null;
+    state.authStateExplicitlySet = false;
+    state.authCache.clear();
     info('Authentication data cleared');
 }
 /**

package/dist/auth/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/auth/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,8CAA8C;AAC9C,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnC,mCAAmC;AACnC,MAAM,SAAS,GAAG,IAAI,WAAW,EAAkB,CAAC;AAEpD,+BAA+B;AAC/B,IAAI,eAAe,GAA0B,IAAI,CAAC;AAElD,8CAA8C;AAC9C,IAAI,SAAS,GAAkB,IAAI,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAA+B;IACzD,eAAe,GAAG,QAAQ,CAAC;IAE3B,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC/B,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,8BAA8B;IAC9B,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEzC,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,uBAAuB;IACvB,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,SAAS,GAAG,MAAM,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,eAAe,GAAG,IAAI,CAAC;IACvB,SAAS,GAAG,IAAI,CAAC;IACjB,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,IAAI,CAAC,6BAA6B,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAqB;IACvD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,qBAAqB;IACrB,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,sBAAsB;IACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACnC,IAAI,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;IAC1B,CAAC;IAED,sBAAsB;IACtB,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC;IACvD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAEjD,kBAAkB;IAClB,OAAO,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/auth/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,8CAA8C;AAC9C,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAanC,SAAS,kBAAkB;IACzB,UAAU,CAAC,oBAAoB,KAAK;QAClC,SAAS,EAAE,IAAI,WAAW,EAAkB;QAC5C,eAAe,EAAE,IAAI;QACrB,sBAAsB,EAAE,KAAK;QAC7B,SAAS,EAAE,IAAI;KAChB,CAAC;IAEF,OAAO,UAAU,CAAC,oBAAoB,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAA+B;IACzD,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,KAAK,CAAC,eAAe,GAAG,QAAQ,CAAC;IACjC,KAAK,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAEpC,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QACpD,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IAEnC,8BAA8B;IAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;QACtC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,WAAW,CAAC,OAAO,CAAC;YACzD,KAAK,CAAC,eAAe,GAAG;gBACtB,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE;oBACJ,EAAE,EAAE,kBAAkB;oBACtB,KAAK,EAAE,WAAW,CAAC,UAAU;oBAC7B,IAAI,EAAE,KAAK;iBACZ;gBACD,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;aACzB,CAAC;YACF,OAAO,KAAK,CAAC,eAAe,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,OAAO,KAAK,CAAC,eAAe,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,kBAAkB,EAAE,CAAC,sBAAsB,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,kBAAkB,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IAEnC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;QACtC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,KAAK,CAAC,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,SAAS,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,sBAAsB,GAAG,KAAK,CAAC;IACrC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACxB,IAAI,CAAC,6BAA6B,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAqB;IACvD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,qBAAqB;IACrB,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,sBAAsB;IACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACnC,IAAI,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;IAC1B,CAAC;IAED,sBAAsB;IACtB,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC;IACvD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAEjD,kBAAkB;IAClB,OAAO,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/auth/verify.d.ts

@@ -21,6 +21,15 @@ export interface VerifyResponse {
         /** @deprecated free 테마 개념 제거됨 - 하위 호환용 */
         free?: string[];
     };
+    quotaEntitlement?: {
+        planId: string;
+        status: string;
+        includedUnits: number;
+        currentPeriodStart: string | null;
+        currentPeriodEnd: string | null;
+        totalAllocatedUnits: number;
+        topUpAllocatedUnits: number;
+    } | null;
     error?: string;
 }
 /**

package/dist/auth/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/auth/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;QAC1C,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC,CAAC;IACH,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,0CAA0C;QAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAoD1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,EAAE,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CASjG"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/auth/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;QAC1C,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC,CAAC;IACH,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,0CAA0C;QAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,GAAG,IAAI,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAoD1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,EAAE,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CASjG"}

package/dist/auth/verify.js.map

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

package/dist/billing/quota-policy.d.ts

@@ -0,0 +1,13 @@
+import type { UsageQuotaSnapshot } from './usage-ledger.js';
+export type QuotaEnforcementMode = 'shadow' | 'soft_cap' | 'hard_cap';
+export interface QuotaPolicyDecision {
+    allowed: boolean;
+    reason: 'ok' | 'quota_exceeded';
+    warning?: string;
+}
+export declare function getQuotaEnforcementMode(): QuotaEnforcementMode;
+export declare function evaluateQuotaPolicy(options: {
+    toolName: string;
+    snapshot: UsageQuotaSnapshot;
+}): QuotaPolicyDecision;
+//# sourceMappingURL=quota-policy.d.ts.map

package/dist/billing/quota-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-policy.d.ts","sourceRoot":"","sources":["../../src/billing/quota-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,gBAAgB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAM9D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,GAAG,mBAAmB,CA6BtB"}

package/dist/billing/quota-policy.js

@@ -0,0 +1,32 @@
+import { getToolMeteringRule } from './tool-metering.js';
+export function getQuotaEnforcementMode() {
+    const raw = process.env.FRAMINGUI_QUOTA_ENFORCEMENT?.trim().toLowerCase();
+    if (raw === 'soft_cap' || raw === 'hard_cap') {
+        return raw;
+    }
+    return 'shadow';
+}
+export function evaluateQuotaPolicy(options) {
+    const rule = getToolMeteringRule(options.toolName);
+    const mode = getQuotaEnforcementMode();
+    if (mode === 'shadow' || !rule.billable || options.snapshot.monthlyIncludedUnits === null) {
+        return { allowed: true, reason: 'ok' };
+    }
+    const projectedUnits = options.snapshot.usedUnits + rule.units;
+    if (projectedUnits <= options.snapshot.monthlyIncludedUnits) {
+        return { allowed: true, reason: 'ok' };
+    }
+    if (mode === 'soft_cap') {
+        return {
+            allowed: true,
+            reason: 'ok',
+            warning: 'Projected usage exceeds the included quota in soft cap mode. This call is allowed, but additional usage would be billable in an enforced rollout.',
+        };
+    }
+    return {
+        allowed: false,
+        reason: 'quota_exceeded',
+        warning: 'Projected usage exceeds the included quota and hard cap mode is enabled. Upgrade or add quota before retrying this tool.',
+    };
+}
+//# sourceMappingURL=quota-policy.js.map

package/dist/billing/quota-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-policy.js","sourceRoot":"","sources":["../../src/billing/quota-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAWzD,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1E,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QAC7C,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAGnC;IACC,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAC;IAEvC,IAAI,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,KAAK,IAAI,EAAE,CAAC;QAC1F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;IAE/D,IAAI,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI;YACZ,OAAO,EACL,mJAAmJ;SACtJ,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,gBAAgB;QACxB,OAAO,EACL,0HAA0H;KAC7H,CAAC;AACJ,CAAC"}

package/dist/billing/tool-metering.d.ts

@@ -0,0 +1,10 @@
+export type ToolMeteringClass = 'account' | 'discovery' | 'context' | 'generation' | 'guarded' | 'execution';
+export interface ToolMeteringRule {
+    toolName: string;
+    billable: boolean;
+    toolClass: ToolMeteringClass;
+    units: number;
+}
+export declare function getToolMeteringRule(toolName: string): ToolMeteringRule;
+export declare function listToolMeteringRules(): ToolMeteringRule[];
+//# sourceMappingURL=tool-metering.d.ts.map

package/dist/billing/tool-metering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-metering.d.ts","sourceRoot":"","sources":["../../src/billing/tool-metering.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,WAAW,GACX,SAAS,GACT,YAAY,GACZ,SAAS,GACT,WAAW,CAAC;AAEhB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAwHD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAOtE;AAED,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CAE1D"}

package/dist/billing/tool-metering.js

@@ -0,0 +1,126 @@
+const TOOL_METERING_RULES = {
+    whoami: {
+        toolName: 'whoami',
+        billable: false,
+        toolClass: 'account',
+        units: 0,
+    },
+    'detect-project-context': {
+        toolName: 'detect-project-context',
+        billable: false,
+        toolClass: 'account',
+        units: 0,
+    },
+    'list-icon-libraries': {
+        toolName: 'list-icon-libraries',
+        billable: true,
+        toolClass: 'discovery',
+        units: 1,
+    },
+    'preview-icon-library': {
+        toolName: 'preview-icon-library',
+        billable: true,
+        toolClass: 'discovery',
+        units: 1,
+    },
+    'list-themes': {
+        toolName: 'list-themes',
+        billable: true,
+        toolClass: 'discovery',
+        units: 1,
+    },
+    'preview-theme': {
+        toolName: 'preview-theme',
+        billable: true,
+        toolClass: 'context',
+        units: 2,
+    },
+    list_tokens: {
+        toolName: 'list_tokens',
+        billable: true,
+        toolClass: 'discovery',
+        units: 1,
+    },
+    'list-components': {
+        toolName: 'list-components',
+        billable: true,
+        toolClass: 'discovery',
+        units: 1,
+    },
+    'preview-component': {
+        toolName: 'preview-component',
+        billable: true,
+        toolClass: 'discovery',
+        units: 1,
+    },
+    'list-screen-templates': {
+        toolName: 'list-screen-templates',
+        billable: true,
+        toolClass: 'discovery',
+        units: 1,
+    },
+    'preview-screen-template': {
+        toolName: 'preview-screen-template',
+        billable: true,
+        toolClass: 'context',
+        units: 2,
+    },
+    'get-screen-generation-context': {
+        toolName: 'get-screen-generation-context',
+        billable: true,
+        toolClass: 'context',
+        units: 2,
+    },
+    'generate-blueprint': {
+        toolName: 'generate-blueprint',
+        billable: true,
+        toolClass: 'generation',
+        units: 4,
+    },
+    generate_screen: {
+        toolName: 'generate_screen',
+        billable: true,
+        toolClass: 'generation',
+        units: 4,
+    },
+    'export-screen': {
+        toolName: 'export-screen',
+        billable: true,
+        toolClass: 'execution',
+        units: 10,
+    },
+    validate_screen: {
+        toolName: 'validate_screen',
+        billable: true,
+        toolClass: 'guarded',
+        units: 6,
+    },
+    'validate-screen-definition': {
+        toolName: 'validate-screen-definition',
+        billable: true,
+        toolClass: 'guarded',
+        units: 6,
+    },
+    'validate-environment': {
+        toolName: 'validate-environment',
+        billable: true,
+        toolClass: 'guarded',
+        units: 6,
+    },
+};
+const DEFAULT_TOOL_RULE = {
+    toolName: 'unknown',
+    billable: true,
+    toolClass: 'execution',
+    units: 10,
+};
+export function getToolMeteringRule(toolName) {
+    return (TOOL_METERING_RULES[toolName] ?? {
+        ...DEFAULT_TOOL_RULE,
+        toolName,
+    });
+}
+export function listToolMeteringRules() {
+    return Object.values(TOOL_METERING_RULES);
+}
+//# sourceMappingURL=tool-metering.js.map

package/dist/billing/tool-metering.js.map

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

package/dist/billing/usage-ledger.d.ts

@@ -0,0 +1,61 @@
+import { type ToolMeteringClass } from './tool-metering.js';
+export type UsageOutcome = 'success' | 'tool_error' | 'validation_error' | 'auth_error' | 'runtime_error';
+export type BillingPlan = 'free' | 'pro' | 'enterprise' | 'master';
+export interface UsageLedgerEntry {
+    id: string;
+    timestamp: string;
+    toolName: string;
+    toolClass: ToolMeteringClass;
+    billable: boolean;
+    units: number;
+    outcome: UsageOutcome;
+    userId: string | null;
+    plan: BillingPlan | null;
+}
+export interface UsageQuotaSnapshot {
+    enabled: boolean;
+    billingPhase: 'shadow';
+    unitModel: 'weighted_tool_units';
+    monthlyIncludedUnits: number | null;
+    usedUnits: number;
+    remainingUnits: number | null;
+    usagePercent: number | null;
+    warningThresholds: number[];
+    warningsTriggered: number[];
+    currentPeriodStart: string;
+    currentPeriodEnd: string;
+}
+export interface PaidQuotaEntitlementSnapshot {
+    planId: string;
+    status: string;
+    includedUnits: number;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    totalAllocatedUnits: number;
+    topUpAllocatedUnits: number;
+}
+interface FraminguiUsageLedgerState {
+    usageLedger: UsageLedgerEntry[];
+    sequence: number;
+}
+declare global {
+    var __framinguiUsageLedgerState: FraminguiUsageLedgerState | undefined;
+}
+export declare function recordToolUsage(options: {
+    toolName: string;
+    outcome: UsageOutcome;
+    userId?: string | null;
+    plan?: string | null;
+    timestamp?: Date;
+}): UsageLedgerEntry;
+export declare function listUsageEntries(): UsageLedgerEntry[];
+export declare function resetUsageLedger(): void;
+export declare function normalizeBillingPlan(plan: string | null | undefined): BillingPlan | null;
+export declare function getUsageQuotaSnapshot(options: {
+    userId?: string | null;
+    plan?: string | null;
+    paidQuotaEntitlement?: PaidQuotaEntitlementSnapshot | null;
+    now?: Date;
+}): UsageQuotaSnapshot;
+export {};
+//# sourceMappingURL=usage-ledger.d.ts.map

package/dist/billing/usage-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-ledger.d.ts","sourceRoot":"","sources":["../../src/billing/usage-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,YAAY,GACZ,kBAAkB,GAClB,YAAY,GACZ,eAAe,CAAC;AAEpB,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,QAAQ,CAAC;IACvB,SAAS,EAAE,qBAAqB,CAAC;IACjC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AASD,UAAU,yBAAyB;IACjC,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,2BAA2B,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACxE;AAiBD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,GAAG,gBAAgB,CAsBnB;AAED,wBAAgB,gBAAgB,IAAI,gBAAgB,EAAE,CAErD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CAKxF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oBAAoB,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAC3D,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,kBAAkB,CAwDrB"}