@nextsparkjs/core 0.1.0-beta.74 → 0.1.0-beta.76

package/dist/lib/services/transactional-meta.service.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Transactional Metadata Service
+ *
+ * Provides atomic operations on metadata with row-level locking (FOR UPDATE).
+ * Critical for financial operations, inventory, counters, or any scenario
+ * where concurrent updates could cause race conditions.
+ *
+ * Key features:
+ * - SELECT FOR UPDATE row-level locking
+ * - Automatic deadlock retry with exponential backoff
+ * - Lock timeout protection
+ * - RLS-aware (uses app.user_id)
+ * - Synchronous update functions to avoid holding locks during I/O
+ *
+ * Usage example:
+ * ```typescript
+ * const newBalance = await TransactionalMetaService.updateWithLock(
+ *   'user',
+ *   userId,
+ *   'credits',
+ *   (current: CreditBalance) => ({
+ *     ...current,
+ *     balance: current.balance - cost
+ *   }),
+ *   userId
+ * )
+ * ```
+ */
+import { EntityType } from '../../types/meta.types';
+/**
+ * Options for transactional operations
+ */
+export interface TransactionalOptions {
+    /**
+     * Lock timeout in milliseconds (default: 5000ms)
+     * Prevents indefinite waiting for locks
+     */
+    lockTimeout?: number;
+    /**
+     * Retry on deadlock (default: true)
+     * Automatically retries when PostgreSQL detects deadlock (error code 40P01)
+     */
+    retryOnDeadlock?: boolean;
+    /**
+     * Maximum retry attempts (default: 3)
+     */
+    maxRetries?: number;
+    /**
+     * Initial retry delay in milliseconds (default: 100ms)
+     * Uses exponential backoff: delay * (2 ^ attempt)
+     */
+    initialRetryDelay?: number;
+}
+/**
+ * Error thrown when a transactional operation fails
+ */
+export declare class TransactionalError extends Error {
+    code?: string;
+    originalError?: Error;
+    constructor(message: string, code?: string, originalError?: Error);
+}
+/**
+ * Service for atomic metadata operations with row-level locking
+ */
+export declare class TransactionalMetaService {
+    private static readonly DEFAULT_OPTIONS;
+    /**
+     * Update metadata with row-level lock (SELECT FOR UPDATE)
+     *
+     * CRITICAL: updateFn MUST be synchronous to avoid holding locks during I/O operations
+     *
+     * @param entityType - Entity type (e.g., 'user', 'product')
+     * @param entityId - Entity ID
+     * @param metaKey - Metadata key
+     * @param updateFn - Synchronous function to transform current value
+     * @param userId - User ID for RLS context
+     * @param options - Transaction options
+     * @returns Updated value
+     *
+     * @throws TransactionalError if update fails
+     * @throws Error if updateFn is async (holds lock during I/O)
+     */
+    static updateWithLock<T = unknown>(entityType: EntityType, entityId: string, metaKey: string, updateFn: (current: T | null) => T, userId: string, options?: TransactionalOptions): Promise<T>;
+    /**
+     * Bulk update multiple metadata keys atomically
+     *
+     * @param entityType - Entity type
+     * @param entityId - Entity ID
+     * @param updates - Object with metaKey: updateFn pairs
+     * @param userId - User ID for RLS context
+     * @param options - Transaction options
+     * @returns Object with updated values
+     */
+    static bulkUpdateWithLock<T extends Record<string, unknown>>(entityType: EntityType, entityId: string, updates: Record<string, (current: unknown) => unknown>, userId: string, options?: TransactionalOptions): Promise<T>;
+    /**
+     * Delete metadata with lock
+     *
+     * @param entityType - Entity type
+     * @param entityId - Entity ID
+     * @param metaKey - Metadata key to delete
+     * @param userId - User ID for RLS context
+     * @returns true if deleted, false if not found
+     */
+    static deleteWithLock(entityType: EntityType, entityId: string, metaKey: string, userId: string): Promise<boolean>;
+}
+//# sourceMappingURL=transactional-meta.service.d.ts.map

package/dist/lib/services/transactional-meta.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-meta.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/transactional-meta.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAuB,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAaxE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAGlC,IAAI,CAAC,EAAE,MAAM;IACb,aAAa,CAAC,EAAE,KAAK;gBAF5B,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,KAAK;CAK/B;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAKtC;IAED;;;;;;;;;;;;;;;OAeG;WACU,cAAc,CAAC,CAAC,GAAG,OAAO,EACrC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,CAAC,CAAC;IAoIb;;;;;;;;;OASG;WACU,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,EACtD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,CAAC,CAAC;IAkBb;;;;;;;;OAQG;WACU,cAAc,CACzB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;CA0CpB"}

package/dist/lib/services/translation.service.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Translation Service
+ *
+ * Provides translation query and loading operations.
+ * Uses pre-computed data from translation-registry for O(1) operations.
+ *
+ * @module TranslationService
+ */
+import { TranslationLoader } from '@nextsparkjs/registries/translation-registry';
+/**
+ * Translation Service - Provides runtime translation queries
+ *
+ * This service layer abstracts translation registry access, making the registry
+ * a pure data structure (Data-Only pattern). All query logic lives here.
+ *
+ * Performance: All operations are O(1) or O(n) with zero I/O.
+ */
+export declare class TranslationService {
+    /**
+     * Get theme translation loader function
+     * Returns a lazy-loading function (doesn't load until called)
+     *
+     * @param theme - Theme name (e.g., 'default')
+     * @param locale - Locale code (e.g., 'en', 'es')
+     * @returns Lazy-loading function or null if not found
+     *
+     * @example
+     * ```typescript
+     * const loader = TranslationService.getLoader('default', 'en')
+     * if (loader) {
+     *   const translations = await loader()
+     * }
+     * ```
+     */
+    static getLoader(theme: string, locale: string): TranslationLoader | null;
+    /**
+     * Load theme translation (executes the loader)
+     * Convenience wrapper that calls the loader function
+     *
+     * @param theme - Theme name
+     * @param locale - Locale code
+     * @returns Translation data or empty object if not found
+     *
+     * @example
+     * ```typescript
+     * const translations = await TranslationService.load('default', 'en')
+     * // Returns translation object or {} if not found
+     * ```
+     */
+    static load(theme: string, locale: string): Promise<Record<string, unknown>>;
+    /**
+     * Get available locales for a theme
+     *
+     * @param theme - Theme name
+     * @returns Array of locale codes
+     *
+     * @example
+     * ```typescript
+     * const locales = TranslationService.getLocales('default')
+     * // Returns ['en', 'es']
+     * ```
+     */
+    static getLocales(theme: string): string[];
+    /**
+     * Get all themes with translations
+     *
+     * @returns Array of theme names
+     *
+     * @example
+     * ```typescript
+     * const themes = TranslationService.getThemes()
+     * // Returns ['default']
+     * ```
+     */
+    static getThemes(): string[];
+    /**
+     * Check if theme has translation for locale
+     *
+     * @param theme - Theme name
+     * @param locale - Locale code
+     * @returns True if translation exists
+     *
+     * @example
+     * ```typescript
+     * if (TranslationService.has('default', 'en')) {
+     *   // Translation exists, safe to load
+     * }
+     * ```
+     */
+    static has(theme: string, locale: string): boolean;
+    /**
+     * Get entity translation loader function
+     * Returns a lazy-loading function (doesn't load until called)
+     *
+     * @param theme - Theme name (e.g., 'default')
+     * @param entity - Entity name (e.g., 'products', 'blog')
+     * @param locale - Locale code (e.g., 'en', 'es')
+     * @returns Lazy-loading function or null if not found
+     *
+     * @example
+     * ```typescript
+     * const loader = TranslationService.getEntityLoader('default', 'products', 'en')
+     * if (loader) {
+     *   const translations = await loader()
+     * }
+     * ```
+     */
+    static getEntityLoader(theme: string, entity: string, locale: string): TranslationLoader | null;
+    /**
+     * Load entity translation (executes the loader)
+     * Convenience wrapper that calls the loader function
+     *
+     * @param theme - Theme name
+     * @param entity - Entity name
+     * @param locale - Locale code
+     * @returns Translation data or empty object if not found
+     *
+     * @example
+     * ```typescript
+     * const translations = await TranslationService.loadEntity('default', 'products', 'en')
+     * // Returns translation object or {} if not found
+     * ```
+     */
+    static loadEntity(theme: string, entity: string, locale: string): Promise<Record<string, unknown>>;
+    /**
+     * Get available locales for an entity in a theme
+     *
+     * @param theme - Theme name
+     * @param entity - Entity name
+     * @returns Array of locale codes
+     *
+     * @example
+     * ```typescript
+     * const locales = TranslationService.getEntityLocales('default', 'products')
+     * // Returns ['en', 'es']
+     * ```
+     */
+    static getEntityLocales(theme: string, entity: string): string[];
+    /**
+     * Get all entities with translations for a theme
+     *
+     * @param theme - Theme name
+     * @returns Array of entity names
+     *
+     * @example
+     * ```typescript
+     * const entities = TranslationService.getEntities('default')
+     * // Returns ['products', 'blog']
+     * ```
+     */
+    static getEntities(theme: string): string[];
+    /**
+     * Check if entity has translation for locale
+     *
+     * @param theme - Theme name
+     * @param entity - Entity name
+     * @param locale - Locale code
+     * @returns True if translation exists
+     *
+     * @example
+     * ```typescript
+     * if (TranslationService.hasEntity('default', 'products', 'en')) {
+     *   // Translation exists, safe to load
+     * }
+     * ```
+     */
+    static hasEntity(theme: string, entity: string, locale: string): boolean;
+    /**
+     * Load all entity translations for a theme and locale
+     * Useful for preloading all entity translations at once
+     *
+     * @param theme - Theme name
+     * @param locale - Locale code
+     * @returns Object with entity names as keys and translations as values
+     *
+     * @example
+     * ```typescript
+     * const allEntityTranslations = await TranslationService.loadAllEntities('default', 'en')
+     * // Returns { products: {...}, blog: {...} }
+     * ```
+     */
+    static loadAllEntities(theme: string, locale: string): Promise<Record<string, Record<string, unknown>>>;
+}
+//# sourceMappingURL=translation.service.d.ts.map

package/dist/lib/services/translation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/translation.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGL,iBAAiB,EAClB,MAAM,8CAA8C,CAAA;AAErD;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAMzE;;;;;;;;;;;;;OAaG;WACU,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAalF;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAM1C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,SAAS,IAAI,MAAM,EAAE;IAI5B;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAQlD;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAU/F;;;;;;;;;;;;;;OAcG;WACU,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAaxG;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAUhE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAM3C;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIxE;;;;;;;;;;;;;OAaG;WACU,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAa9G"}

package/dist/lib/services/usage.service.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Usage Service
+ *
+ * Provides usage tracking and quota management functions.
+ * Uses a hybrid 2-table approach (usage + usage_events) for O(1) checks
+ * and detailed audit trail.
+ *
+ * @module UsageService
+ */
+import type { Usage, UsageEvent, UserUsageSummary, TopConsumer, TeamUsageSummary } from '../billing/types';
+export interface TrackUsageParams {
+    teamId: string;
+    userId: string;
+    limitSlug: string;
+    delta: number;
+    action?: string;
+    resourceType?: string;
+    resourceId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UsageTimelineOptions {
+    limitSlug?: string;
+    startDate?: Date;
+    endDate?: Date;
+    limit?: number;
+}
+export declare class UsageService {
+    /**
+     * Get usage record for a specific subscription, limit, and period
+     *
+     * @param subscriptionId - Subscription ID
+     * @param limitSlug - Limit slug
+     * @param periodKey - Period key (e.g., '2024-01')
+     * @returns Usage record or null
+     *
+     * @example
+     * const usage = await UsageService.get('sub-123', 'projects', '2024-01')
+     */
+    static get(subscriptionId: string, limitSlug: string, periodKey: string): Promise<Usage | null>;
+    /**
+     * Get current usage value for a subscription and limit
+     *
+     * @param subscriptionId - Subscription ID
+     * @param limitSlug - Limit slug
+     * @returns Current usage value (0 if not found)
+     *
+     * @example
+     * const current = await UsageService.getCurrent('sub-123', 'api_calls')
+     */
+    static getCurrent(subscriptionId: string, limitSlug: string): Promise<number>;
+    /**
+     * Get all usage records for a subscription in current period
+     *
+     * @param subscriptionId - Subscription ID
+     * @returns Array of usage records
+     *
+     * @example
+     * const allUsage = await UsageService.getAll('sub-123')
+     */
+    static getAll(subscriptionId: string): Promise<Usage[]>;
+    /**
+     * Get current usage for a team by limit slug
+     * Convenience method that doesn't require subscriptionId
+     *
+     * @param teamId - Team ID
+     * @param limitSlug - Limit slug
+     * @returns Current usage value (0 if not found)
+     *
+     * @example
+     * const apiCalls = await UsageService.getByTeam('team-123', 'api_calls')
+     */
+    static getByTeam(teamId: string, limitSlug: string): Promise<number>;
+    /**
+     * List subscriptions near their quota threshold
+     *
+     * @param percentThreshold - Percentage threshold (e.g., 80 means >= 80% used)
+     * @param limitSlug - Optional limit slug to check (all limits if not specified)
+     * @returns Array of subscriptions with their usage info
+     *
+     * @example
+     * const nearLimit = await UsageService.listNearQuota(80, 'api_calls')
+     */
+    static listNearQuota(percentThreshold?: number, limitSlug?: string): Promise<Array<{
+        subscriptionId: string;
+        teamId: string;
+        planSlug: string;
+        limitSlug: string;
+        current: number;
+        max: number;
+        percentUsed: number;
+    }>>;
+    /**
+     * Get usage trend over multiple periods
+     *
+     * @param subscriptionId - Subscription ID
+     * @param limitSlug - Limit slug
+     * @param periods - Number of periods to look back
+     * @returns Array of usage by period
+     *
+     * @example
+     * const trend = await UsageService.getTrend('sub-123', 'api_calls', 6)
+     */
+    static getTrend(subscriptionId: string, limitSlug: string, periods?: number): Promise<Array<{
+        periodKey: string;
+        value: number;
+    }>>;
+    /**
+     * Track usage - Updates both usage and usage_events tables atomically
+     *
+     * This is the primary function for recording quota consumption.
+     * It updates the aggregate usage table (for fast O(1) checks) and
+     * creates a detailed event record (for reporting and audit).
+     *
+     * @param params - Usage tracking parameters
+     * @returns Updated usage record
+     *
+     * @example
+     * const usage = await UsageService.track({
+     *   teamId: 'team-123',
+     *   userId: 'user-456',
+     *   limitSlug: 'api_calls',
+     *   delta: 1,
+     *   action: 'api.request',
+     * })
+     */
+    static track(params: TrackUsageParams): Promise<Usage>;
+    /**
+     * Increment usage (convenience wrapper)
+     *
+     * @param subscriptionId - Subscription ID
+     * @param limitSlug - Limit slug
+     * @param amount - Amount to increment (default: 1)
+     * @returns Updated usage record
+     *
+     * @example
+     * const usage = await UsageService.increment('sub-123', 'api_calls')
+     */
+    static increment(subscriptionId: string, limitSlug: string, amount?: number): Promise<Usage>;
+    /**
+     * Decrement usage
+     *
+     * @param subscriptionId - Subscription ID
+     * @param limitSlug - Limit slug
+     * @param amount - Amount to decrement (default: 1)
+     * @returns Updated usage record
+     *
+     * @example
+     * await UsageService.decrement('sub-123', 'projects', 1)
+     */
+    static decrement(subscriptionId: string, limitSlug: string, amount?: number): Promise<Usage>;
+    /**
+     * Reset usage for a subscription
+     *
+     * @param subscriptionId - Subscription ID
+     * @param limitSlug - Optional limit slug (if not provided, resets all)
+     *
+     * @example
+     * // Reset specific limit
+     * await UsageService.reset('sub-123', 'api_calls')
+     *
+     * // Reset all limits
+     * await UsageService.reset('sub-123')
+     */
+    static reset(subscriptionId: string, limitSlug?: string): Promise<void>;
+    /**
+     * Process monthly usage reset (batch job)
+     * Resets usage for all limits with monthly reset period
+     *
+     * @returns Number of records reset
+     *
+     * @example
+     * const count = await UsageService.processMonthlyReset()
+     */
+    static processMonthlyReset(): Promise<number>;
+    /**
+     * Get usage breakdown by user for a team
+     *
+     * @param teamId - Team ID
+     * @param periodKey - Period key (e.g., '2024-01')
+     * @returns Array of user usage summaries
+     *
+     * @example
+     * const byUser = await UsageService.getTeamUsageByUser('team-123', '2024-01')
+     */
+    static getTeamUsageByUser(teamId: string, periodKey: string): Promise<UserUsageSummary[]>;
+    /**
+     * Get top consumers for a specific limit
+     *
+     * @param teamId - Team ID
+     * @param limitSlug - Limit slug
+     * @param periodKey - Period key
+     * @param limit - Number of top consumers (default: 5)
+     * @returns Array of top consumers
+     *
+     * @example
+     * const top = await UsageService.getTopConsumers('team-123', 'api_calls', '2024-01')
+     */
+    static getTopConsumers(teamId: string, limitSlug: string, periodKey: string, limit?: number): Promise<TopConsumer[]>;
+    /**
+     * Get user usage timeline
+     *
+     * @param userId - User ID
+     * @param options - Query options
+     * @returns Array of usage events
+     *
+     * @example
+     * const timeline = await UsageService.getUserTimeline('user-123', {
+     *   limitSlug: 'api_calls',
+     *   limit: 50,
+     * })
+     */
+    static getUserTimeline(userId: string, options?: UsageTimelineOptions): Promise<UsageEvent[]>;
+    /**
+     * Get comprehensive team usage summary
+     *
+     * @param teamId - Team ID
+     * @param periodKey - Period key (default: current month)
+     * @returns Complete team usage summary
+     *
+     * @example
+     * const summary = await UsageService.getTeamSummary('team-123')
+     */
+    static getTeamSummary(teamId: string, periodKey?: string): Promise<TeamUsageSummary>;
+}
+//# sourceMappingURL=usage.service.d.ts.map

package/dist/lib/services/usage.service.d.ts.map

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

package/dist/lib/services/user-flags.service.d.ts

@@ -0,0 +1,65 @@
+/**
+ * User Flags Service
+ *
+ * Service for retrieving and managing user flags from metadata system.
+ * Flags are stored in user metadata and control feature access.
+ */
+import type { UserFlag } from '../entities/types';
+/**
+ * UserFlagsService - Main service for user flags management
+ */
+export declare class UserFlagsService {
+    /**
+     * Get user flags from metadata
+     */
+    static getUserFlags(userId: string): Promise<UserFlag[]>;
+    /**
+     * Set user flags in metadata
+     */
+    static setUserFlags(userId: string, flags: UserFlag[]): Promise<void>;
+    /**
+     * Add a flag to user
+     */
+    static addUserFlag(userId: string, flag: UserFlag): Promise<void>;
+    /**
+     * Remove a flag from user
+     */
+    static removeUserFlag(userId: string, flag: UserFlag): Promise<void>;
+    /**
+     * Check if user has a specific flag
+     */
+    static hasFlag(userId: string, flag: UserFlag): Promise<boolean>;
+    /**
+     * Check if user has any of the specified flags
+     */
+    static hasAnyFlag(userId: string, flags: UserFlag[]): Promise<boolean>;
+    /**
+     * Check if user has all of the specified flags
+     */
+    static hasAllFlags(userId: string, flags: UserFlag[]): Promise<boolean>;
+    /**
+     * Validate flags array
+     */
+    private static validateFlags;
+    /**
+     * Clear cache for a user (useful when flags are updated externally)
+     */
+    static clearUserCache(userId: string): void;
+    /**
+     * Clear all cache (useful for testing)
+     */
+    static clearAllCache(): void;
+    /**
+     * Get bulk user flags for multiple users (optimized for performance)
+     */
+    static getBulkUserFlags(userIds: string[]): Promise<Record<string, UserFlag[]>>;
+}
+export declare const getUserFlags: any;
+export declare const setUserFlags: any;
+export declare const addUserFlag: any;
+export declare const removeUserFlag: any;
+export declare const hasFlag: any;
+export declare const hasAnyFlag: any;
+export declare const hasAllFlags: any;
+export declare const getBulkUserFlags: any;
+//# sourceMappingURL=user-flags.service.d.ts.map

package/dist/lib/services/user-flags.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-flags.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/user-flags.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAclD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;WACU,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgC9D;;OAEG;WACU,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B3E;;OAEG;WACU,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvE;;OAEG;WACU,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1E;;OAEG;WACU,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtE;;OAEG;WACU,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5E;;OAEG;WACU,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAgB5B;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAM5B;;OAEG;WACU,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;CAmDtF;AAGD,eAAO,MAAM,YAAY,KAAuD,CAAC;AACjF,eAAO,MAAM,YAAY,KAAuD,CAAC;AACjF,eAAO,MAAM,WAAW,KAAsD,CAAC;AAC/E,eAAO,MAAM,cAAc,KAAyD,CAAC;AACrF,eAAO,MAAM,OAAO,KAAkD,CAAC;AACvE,eAAO,MAAM,UAAU,KAAqD,CAAC;AAC7E,eAAO,MAAM,WAAW,KAAsD,CAAC;AAC/E,eAAO,MAAM,gBAAgB,KAA2D,CAAC"}