@qwickapps/server 1.4.0 → 1.5.1

package/dist/plugins/usage/stores/postgres-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../../../../src/plugins/usage/stores/postgres-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EAGV,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAsBrB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,UAAU,CA6K/E"}

package/dist/plugins/usage/stores/postgres-store.js

@@ -0,0 +1,146 @@
+/**
+ * PostgreSQL Usage Store
+ *
+ * Usage tracking storage implementation using PostgreSQL.
+ * Tracks daily and monthly usage counters.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Get current date in YYYY-MM-DD format
+ */
+function getCurrentDate() {
+    return new Date().toISOString().split('T')[0];
+}
+/**
+ * Get current year-month in YYYY-MM format
+ */
+function getCurrentYearMonth() {
+    const now = new Date();
+    return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`;
+}
+/**
+ * Create a PostgreSQL usage store
+ */
+export function postgresUsageStore(config) {
+    const { pool: poolOrFn, dailyTable = 'usage_daily', monthlyTable = 'usage_monthly', schema = 'public', autoCreateTables = true, } = config;
+    // Helper to get pool (supports lazy initialization via function)
+    const getPool = () => {
+        const pool = typeof poolOrFn === 'function' ? poolOrFn() : poolOrFn;
+        return pool;
+    };
+    const dailyTableFull = `"${schema}"."${dailyTable}"`;
+    const monthlyTableFull = `"${schema}"."${monthlyTable}"`;
+    return {
+        name: 'postgres',
+        async initialize() {
+            if (!autoCreateTables)
+                return;
+            // Create usage_daily table
+            await getPool().query(`
+        CREATE TABLE IF NOT EXISTS ${dailyTableFull} (
+          id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+          user_id UUID NOT NULL,
+          feature_code VARCHAR(100) NOT NULL,
+          date DATE NOT NULL DEFAULT CURRENT_DATE,
+          count INTEGER DEFAULT 0,
+          metadata JSONB DEFAULT '{}',
+          created_at TIMESTAMPTZ DEFAULT NOW(),
+          updated_at TIMESTAMPTZ DEFAULT NOW(),
+          UNIQUE(user_id, feature_code, date)
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_${dailyTable}_user_date ON ${dailyTableFull}(user_id, date);
+        CREATE INDEX IF NOT EXISTS idx_${dailyTable}_feature ON ${dailyTableFull}(feature_code);
+        CREATE INDEX IF NOT EXISTS idx_${dailyTable}_date ON ${dailyTableFull}(date);
+      `);
+            // Create usage_monthly table
+            await getPool().query(`
+        CREATE TABLE IF NOT EXISTS ${monthlyTableFull} (
+          id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+          user_id UUID NOT NULL,
+          feature_code VARCHAR(100) NOT NULL,
+          year_month VARCHAR(7) NOT NULL,
+          count INTEGER DEFAULT 0,
+          metadata JSONB DEFAULT '{}',
+          created_at TIMESTAMPTZ DEFAULT NOW(),
+          updated_at TIMESTAMPTZ DEFAULT NOW(),
+          UNIQUE(user_id, feature_code, year_month)
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_${monthlyTable}_user ON ${monthlyTableFull}(user_id, year_month);
+        CREATE INDEX IF NOT EXISTS idx_${monthlyTable}_feature ON ${monthlyTableFull}(feature_code);
+      `);
+        },
+        async getDailyUsage(userId, featureCode, date) {
+            const targetDate = date || getCurrentDate();
+            const result = await getPool().query(`SELECT * FROM ${dailyTableFull}
+         WHERE user_id = $1 AND feature_code = $2 AND date = $3`, [userId, featureCode, targetDate]);
+            return result.rows[0] || null;
+        },
+        async getMonthlyUsage(userId, featureCode, yearMonth) {
+            const targetMonth = yearMonth || getCurrentYearMonth();
+            const result = await getPool().query(`SELECT * FROM ${monthlyTableFull}
+         WHERE user_id = $1 AND feature_code = $2 AND year_month = $3`, [userId, featureCode, targetMonth]);
+            return result.rows[0] || null;
+        },
+        async incrementDaily(userId, featureCode, amount = 1, date) {
+            const targetDate = date || getCurrentDate();
+            const yearMonth = targetDate.substring(0, 7); // Extract YYYY-MM from YYYY-MM-DD
+            // Increment daily usage (upsert)
+            const dailyResult = await getPool().query(`INSERT INTO ${dailyTableFull} (user_id, feature_code, date, count)
+         VALUES ($1, $2, $3, $4)
+         ON CONFLICT (user_id, feature_code, date)
+         DO UPDATE SET count = ${dailyTableFull}.count + $4, updated_at = NOW()
+         RETURNING count`, [userId, featureCode, targetDate, amount]);
+            const newCount = dailyResult.rows[0].count;
+            // Also increment monthly usage
+            await getPool().query(`INSERT INTO ${monthlyTableFull} (user_id, feature_code, year_month, count)
+         VALUES ($1, $2, $3, $4)
+         ON CONFLICT (user_id, feature_code, year_month)
+         DO UPDATE SET count = ${monthlyTableFull}.count + $4, updated_at = NOW()`, [userId, featureCode, yearMonth, amount]);
+            return newCount;
+        },
+        async getAllDailyUsage(userId, date) {
+            const targetDate = date || getCurrentDate();
+            const result = await getPool().query(`SELECT * FROM ${dailyTableFull}
+         WHERE user_id = $1 AND date = $2
+         ORDER BY feature_code`, [userId, targetDate]);
+            return result.rows;
+        },
+        async getAllMonthlyUsage(userId, yearMonth) {
+            const targetMonth = yearMonth || getCurrentYearMonth();
+            const result = await getPool().query(`SELECT * FROM ${monthlyTableFull}
+         WHERE user_id = $1 AND year_month = $2
+         ORDER BY feature_code`, [userId, targetMonth]);
+            return result.rows;
+        },
+        async resetDailyUsage(userId, featureCode, date) {
+            const targetDate = date || getCurrentDate();
+            await getPool().query(`UPDATE ${dailyTableFull}
+         SET count = 0, updated_at = NOW()
+         WHERE user_id = $1 AND feature_code = $2 AND date = $3`, [userId, featureCode, targetDate]);
+        },
+        async cleanupOldDaily(daysToKeep) {
+            // Calculate cutoff date to avoid SQL interpolation
+            const cutoffDate = new Date();
+            cutoffDate.setDate(cutoffDate.getDate() - daysToKeep);
+            const cutoffDateStr = cutoffDate.toISOString().split('T')[0];
+            const result = await getPool().query(`DELETE FROM ${dailyTableFull} WHERE date < $1`, [cutoffDateStr]);
+            return result.rowCount ?? 0;
+        },
+        async cleanupOldMonthly(monthsToKeep) {
+            // Calculate the cutoff year-month
+            const now = new Date();
+            now.setMonth(now.getMonth() - monthsToKeep);
+            const cutoffMonth = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`;
+            const result = await getPool().query(`DELETE FROM ${monthlyTableFull}
+         WHERE year_month < $1`, [cutoffMonth]);
+            return result.rowCount ?? 0;
+        },
+        async shutdown() {
+            // Pool is managed externally, nothing to do here
+        },
+    };
+}
+//# sourceMappingURL=postgres-store.js.map

package/dist/plugins/usage/stores/postgres-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-store.js","sourceRoot":"","sources":["../../../../src/plugins/usage/stores/postgres-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH;;GAEG;AACH,SAAS,cAAc;IACrB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB;IAC1B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAgC;IACjE,MAAM,EACJ,IAAI,EAAE,QAAQ,EACd,UAAU,GAAG,aAAa,EAC1B,YAAY,GAAG,eAAe,EAC9B,MAAM,GAAG,QAAQ,EACjB,gBAAgB,GAAG,IAAI,GACxB,GAAG,MAAM,CAAC;IAEX,iEAAiE;IACjE,MAAM,OAAO,GAAG,GAAW,EAAE;QAC3B,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACpE,OAAO,IAAc,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,IAAI,MAAM,MAAM,UAAU,GAAG,CAAC;IACrD,MAAM,gBAAgB,GAAG,IAAI,MAAM,MAAM,YAAY,GAAG,CAAC;IAEzD,OAAO;QACL,IAAI,EAAE,UAAU;QAEhB,KAAK,CAAC,UAAU;YACd,IAAI,CAAC,gBAAgB;gBAAE,OAAO;YAE9B,2BAA2B;YAC3B,MAAM,OAAO,EAAE,CAAC,KAAK,CAAC;qCACS,cAAc;;;;;;;;;;;;yCAYV,UAAU,iBAAiB,cAAc;yCACzC,UAAU,eAAe,cAAc;yCACvC,UAAU,YAAY,cAAc;OACtE,CAAC,CAAC;YAEH,6BAA6B;YAC7B,MAAM,OAAO,EAAE,CAAC,KAAK,CAAC;qCACS,gBAAgB;;;;;;;;;;;;yCAYZ,YAAY,YAAY,gBAAgB;yCACxC,YAAY,eAAe,gBAAgB;OAC7E,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,WAAmB,EAAE,IAAa;YACpE,MAAM,UAAU,GAAG,IAAI,IAAI,cAAc,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,KAAK,CAClC,iBAAiB,cAAc;gEACyB,EACxD,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAClC,CAAC;YACF,OAAQ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAgB,IAAI,IAAI,CAAC;QAChD,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,MAAc,EAAE,WAAmB,EAAE,SAAkB;YAC3E,MAAM,WAAW,GAAG,SAAS,IAAI,mBAAmB,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,KAAK,CAClC,iBAAiB,gBAAgB;sEAC6B,EAC9D,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CACnC,CAAC;YACF,OAAQ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAkB,IAAI,IAAI,CAAC;QAClD,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,WAAmB,EAAE,MAAM,GAAG,CAAC,EAAE,IAAa;YACjF,MAAM,UAAU,GAAG,IAAI,IAAI,cAAc,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,kCAAkC;YAEhF,iCAAiC;YACjC,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC,KAAK,CACvC,eAAe,cAAc;;;iCAGJ,cAAc;yBACtB,EACjB,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAC1C,CAAC;YAEF,MAAM,QAAQ,GAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAuB,CAAC,KAAK,CAAC;YAElE,+BAA+B;YAC/B,MAAM,OAAO,EAAE,CAAC,KAAK,CACnB,eAAe,gBAAgB;;;iCAGN,gBAAgB,iCAAiC,EAC1E,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CACzC,CAAC;YAEF,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,IAAa;YAClD,MAAM,UAAU,GAAG,IAAI,IAAI,cAAc,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,KAAK,CAClC,iBAAiB,cAAc;;+BAER,EACvB,CAAC,MAAM,EAAE,UAAU,CAAC,CACrB,CAAC;YACF,OAAO,MAAM,CAAC,IAAoB,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,kBAAkB,CAAC,MAAc,EAAE,SAAkB;YACzD,MAAM,WAAW,GAAG,SAAS,IAAI,mBAAmB,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,KAAK,CAClC,iBAAiB,gBAAgB;;+BAEV,EACvB,CAAC,MAAM,EAAE,WAAW,CAAC,CACtB,CAAC;YACF,OAAO,MAAM,CAAC,IAAsB,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,MAAc,EAAE,WAAmB,EAAE,IAAa;YACtE,MAAM,UAAU,GAAG,IAAI,IAAI,cAAc,EAAE,CAAC;YAC5C,MAAM,OAAO,EAAE,CAAC,KAAK,CACnB,UAAU,cAAc;;gEAEgC,EACxD,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAClC,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,UAAkB;YACtC,mDAAmD;YACnD,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;YAC9B,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC;YACtD,MAAM,aAAa,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAE7D,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,KAAK,CAClC,eAAe,cAAc,kBAAkB,EAC/C,CAAC,aAAa,CAAC,CAChB,CAAC;YACF,OAAO,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC9B,CAAC;QAED,KAAK,CAAC,iBAAiB,CAAC,YAAoB;YAC1C,kCAAkC;YAClC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,YAAY,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAE1F,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,KAAK,CAClC,eAAe,gBAAgB;+BACR,EACvB,CAAC,WAAW,CAAC,CACd,CAAC;YACF,OAAO,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC9B,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,iDAAiD;QACnD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/usage/types.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Usage Plugin Types
+ *
+ * Type definitions for usage tracking with daily/monthly counters.
+ * Integrates with subscriptions-plugin for limit enforcement.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Daily usage record
+ */
+export interface DailyUsage {
+    /** Primary key - UUID */
+    id: string;
+    /** User ID */
+    user_id: string;
+    /** Feature code (e.g., 'ai_messages', 'vision_calls') */
+    feature_code: string;
+    /** Date (YYYY-MM-DD) */
+    date: string;
+    /** Usage count */
+    count: number;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** When the record was created */
+    created_at: Date;
+    /** When the record was last updated */
+    updated_at: Date;
+}
+/**
+ * Monthly usage record
+ */
+export interface MonthlyUsage {
+    /** Primary key - UUID */
+    id: string;
+    /** User ID */
+    user_id: string;
+    /** Feature code */
+    feature_code: string;
+    /** Year-month (YYYY-MM) */
+    year_month: string;
+    /** Usage count */
+    count: number;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** When the record was created */
+    created_at: Date;
+    /** When the record was last updated */
+    updated_at: Date;
+}
+/**
+ * Usage increment result
+ */
+export interface UsageIncrementResult {
+    /** Whether the increment was allowed */
+    allowed: boolean;
+    /** Current count after increment (if allowed) */
+    current_count: number;
+    /** Limit value (-1 = unlimited) */
+    limit: number | null;
+    /** Remaining quota */
+    remaining: number | null;
+    /** When the counter resets */
+    resets_at?: Date;
+    /** Reason if not allowed */
+    reason?: string;
+}
+/**
+ * Usage status for a feature
+ */
+export interface UsageStatus {
+    /** Feature code */
+    feature_code: string;
+    /** Current usage count */
+    current: number;
+    /** Limit value (-1 = unlimited, null = no subscription) */
+    limit: number | null;
+    /** Remaining quota (-1 = unlimited) */
+    remaining: number | null;
+    /** When the counter resets */
+    resets_at: Date;
+    /** Percentage used (0-100, null if unlimited) */
+    percentage_used: number | null;
+}
+/**
+ * Usage summary for a user
+ */
+export interface UsageSummary {
+    /** User ID */
+    user_id: string;
+    /** Period (daily or monthly) */
+    period: 'daily' | 'monthly';
+    /** Period date/month */
+    period_value: string;
+    /** Usage by feature */
+    features: UsageStatus[];
+}
+/**
+ * Usage store interface
+ */
+export interface UsageStore {
+    /** Store name (e.g., 'postgres') */
+    name: string;
+    /**
+     * Initialize the store (create tables, etc.)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get daily usage for a user and feature
+     */
+    getDailyUsage(userId: string, featureCode: string, date?: string): Promise<DailyUsage | null>;
+    /**
+     * Get monthly usage for a user and feature
+     */
+    getMonthlyUsage(userId: string, featureCode: string, yearMonth?: string): Promise<MonthlyUsage | null>;
+    /**
+     * Increment daily usage (also updates monthly)
+     */
+    incrementDaily(userId: string, featureCode: string, amount?: number, date?: string): Promise<number>;
+    /**
+     * Get all daily usage for a user on a date
+     */
+    getAllDailyUsage(userId: string, date?: string): Promise<DailyUsage[]>;
+    /**
+     * Get all monthly usage for a user
+     */
+    getAllMonthlyUsage(userId: string, yearMonth?: string): Promise<MonthlyUsage[]>;
+    /**
+     * Reset daily usage for a user and feature
+     */
+    resetDailyUsage(userId: string, featureCode: string, date?: string): Promise<void>;
+    /**
+     * Cleanup old daily records
+     */
+    cleanupOldDaily(daysToKeep: number): Promise<number>;
+    /**
+     * Cleanup old monthly records
+     */
+    cleanupOldMonthly(monthsToKeep: number): Promise<number>;
+    /**
+     * Shutdown the store
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * PostgreSQL usage store configuration
+ */
+export interface PostgresUsageStoreConfig {
+    /** PostgreSQL pool instance or a function that returns one */
+    pool: unknown | (() => unknown);
+    /** Daily usage table name (default: 'usage_daily') */
+    dailyTable?: string;
+    /** Monthly usage table name (default: 'usage_monthly') */
+    monthlyTable?: string;
+    /** Schema name (default: 'public') */
+    schema?: string;
+    /** Auto-create tables on init (default: true) */
+    autoCreateTables?: boolean;
+}
+/**
+ * API configuration
+ */
+export interface UsageApiConfig {
+    /** API route prefix (default: '/usage') */
+    prefix?: string;
+    /** Enable usage endpoints */
+    enabled?: boolean;
+}
+/**
+ * Cleanup configuration
+ */
+export interface UsageCleanupConfig {
+    /** Days to keep daily records (default: 90) */
+    dailyRetentionDays?: number;
+    /** Months to keep monthly records (default: 24) */
+    monthlyRetentionMonths?: number;
+    /** Run cleanup on startup */
+    runOnStartup?: boolean;
+    /** Cleanup interval in hours (0 = disabled) */
+    cleanupIntervalHours?: number;
+}
+/**
+ * Usage plugin configuration
+ */
+export interface UsagePluginConfig {
+    /** Usage storage backend */
+    store: UsageStore;
+    /** API configuration */
+    api?: UsageApiConfig;
+    /** Cleanup configuration */
+    cleanup?: UsageCleanupConfig;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/usage/types.d.ts.map

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

package/dist/plugins/usage/types.js

@@ -0,0 +1,10 @@
+/**
+ * Usage Plugin Types
+ *
+ * Type definitions for usage tracking with daily/monthly counters.
+ * Integrates with subscriptions-plugin for limit enforcement.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/usage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/usage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/plugins/usage/usage-plugin.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Usage Plugin
+ *
+ * Usage tracking plugin for @qwickapps/server.
+ * Tracks daily/monthly feature usage and enforces limits.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { Plugin } from '../../core/plugin-registry.js';
+import type { UsagePluginConfig, UsageStore, UsageIncrementResult, UsageStatus, UsageSummary } from './types.js';
+/**
+ * Create the Usage plugin
+ */
+export declare function createUsagePlugin(config: UsagePluginConfig): Plugin;
+/**
+ * Get the current usage store instance
+ */
+export declare function getUsageStore(): UsageStore | null;
+/**
+ * Get current daily usage for a feature
+ */
+export declare function getDailyUsage(userId: string, featureCode: string): Promise<number>;
+/**
+ * Increment usage and check limit
+ */
+export declare function incrementUsage(userId: string, featureCode: string, amount?: number): Promise<UsageIncrementResult>;
+/**
+ * Check if usage is within limit (without incrementing)
+ */
+export declare function checkUsageLimit(userId: string, featureCode: string, amount?: number): Promise<UsageIncrementResult>;
+/**
+ * Get usage status for a specific feature
+ */
+export declare function getFeatureUsageStatus(userId: string, featureCode: string): Promise<UsageStatus>;
+/**
+ * Get daily usage summary for all features
+ */
+export declare function getDailyUsageSummary(userId: string, date?: string): Promise<UsageSummary>;
+/**
+ * Reset usage for a feature (admin function)
+ */
+export declare function resetUsage(userId: string, featureCode: string): Promise<void>;
+/**
+ * Get remaining quota for a feature
+ */
+export declare function getRemainingQuota(userId: string, featureCode: string): Promise<number | null>;
+/**
+ * Check if user can use a feature (has remaining quota)
+ */
+export declare function canUseFeature(userId: string, featureCode: string, amount?: number): Promise<boolean>;
+//# sourceMappingURL=usage-plugin.d.ts.map

package/dist/plugins/usage/usage-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/usage/usage-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAgC,MAAM,+BAA+B,CAAC;AAC1F,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EAEV,oBAAoB,EACpB,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AA2BpB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA2KnE;AAMD;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,SAAI,GACT,OAAO,CAAC,oBAAoB,CAAC,CA0D/B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,SAAI,GACT,OAAO,CAAC,oBAAoB,CAAC,CA4C/B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoCrG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAgD/F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGnG;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAGrG"}