@nindroidsystems/pluginator 2.3.0

package/dist/core/templates/template-service.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Template Service
+ *
+ * Manages template lifecycle: create, read, update, delete, search.
+ *
+ * @since v1.69.0
+ */
+import type { ConfigTemplate, TemplateApplyOptions, TemplateApplyResult, TemplateMetadata, TemplateRenderResult, TemplateSearchOptions, TemplateSearchResult, TemplateValidationResult, TemplateVariableValues } from './template-types.js';
+/**
+ * Template service for managing templates
+ */
+export declare class TemplateService {
+    private templates;
+    private engine;
+    private validator;
+    constructor();
+    /**
+     * Register a template
+     */
+    register(template: ConfigTemplate): TemplateValidationResult;
+    /**
+     * Get a template by ID
+     */
+    get(id: string): ConfigTemplate | undefined;
+    /**
+     * Check if template exists
+     */
+    has(id: string): boolean;
+    /**
+     * Remove a template
+     */
+    remove(id: string): boolean;
+    /**
+     * Get all templates
+     */
+    getAll(): ConfigTemplate[];
+    /**
+     * Search templates
+     */
+    search(options?: TemplateSearchOptions): TemplateSearchResult;
+    /**
+     * Get templates for a specific plugin
+     */
+    getForPlugin(pluginId: string): ConfigTemplate[];
+    /**
+     * Get templates by category
+     */
+    getByCategory(category: ConfigTemplate['category']): ConfigTemplate[];
+    /**
+     * Render a template with variables
+     */
+    render(templateId: string, variables: TemplateVariableValues): TemplateRenderResult | undefined;
+    /**
+     * Preview rendering without applying
+     */
+    preview(templateId: string, variables: TemplateVariableValues): TemplateRenderResult | undefined;
+    /**
+     * Apply a template (render + write files)
+     * Note: Actual file writing should be done by caller
+     */
+    apply(templateId: string, variables: TemplateVariableValues, options?: TemplateApplyOptions): TemplateApplyResult | undefined;
+    /**
+     * Validate a template
+     */
+    validate(template: ConfigTemplate): TemplateValidationResult;
+    /**
+     * Validate variable values
+     */
+    validateVariables(templateId: string, variables: TemplateVariableValues): TemplateValidationResult | undefined;
+    /**
+     * Create a new template from scratch
+     */
+    create(partial: Partial<ConfigTemplate> & Pick<ConfigTemplate, 'id' | 'name' | 'plugins'>): ConfigTemplate;
+    /**
+     * Duplicate a template with a new ID
+     */
+    duplicate(templateId: string, newId: string): ConfigTemplate | undefined;
+    /**
+     * Update template metadata
+     */
+    updateMetadata(templateId: string, updates: Partial<TemplateMetadata>): boolean;
+    /**
+     * Get template count
+     */
+    count(): number;
+    /**
+     * Clear all templates
+     */
+    clear(): void;
+    private resolveInheritance;
+    private mergeVariables;
+    private applyDefaults;
+}
+/**
+ * Get template service singleton
+ */
+export declare function getTemplateService(): TemplateService;
+/**
+ * Reset template service (for testing)
+ */
+export declare function resetTemplateService(): void;
+//# sourceMappingURL=template-service.d.ts.map

package/dist/core/templates/template-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-service.d.ts","sourceRoot":"","sources":["../../../src/core/templates/template-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAG7B;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAoB;;IAOrC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,wBAAwB;IAU5D;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;OAEG;IACH,MAAM,CAAC,OAAO,GAAE,qBAA0B,GAAG,oBAAoB;IAoEjE;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAIhD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,cAAc,EAAE;IAIrE;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,GAAG,oBAAoB,GAAG,SAAS;IA8B/F;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,GAAG,oBAAoB,GAAG,SAAS;IAIhG;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,GAAG,SAAS;IA4DjI;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,wBAAwB;IAI5D;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,GAAG,wBAAwB,GAAG,SAAS;IAS9G;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,cAAc;IA4B1G;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAyBxE;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO;IAe/E;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,aAAa;CAWtB;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/core/templates/template-sync.d.ts

@@ -0,0 +1,252 @@
+/**
+ * Template Sync Service
+ *
+ * Synchronizes templates across servers with drift detection
+ * and compliance reporting.
+ *
+ * @since v1.69.5
+ */
+import type { ConfigTemplate, TemplateVariableValues } from './template-types.js';
+/**
+ * Server configuration for sync
+ */
+export interface SyncServer {
+    id: string;
+    name: string;
+    path: string;
+    templateId?: string;
+    variables?: TemplateVariableValues;
+    lastSync?: string;
+    status: 'synced' | 'drifted' | 'unknown' | 'error';
+}
+/**
+ * Drift detection result
+ */
+export interface DriftResult {
+    serverId: string;
+    templateId: string;
+    hasDrift: boolean;
+    driftedFiles: DriftedFile[];
+    checkedAt: string;
+}
+/**
+ * Drifted file details
+ */
+export interface DriftedFile {
+    path: string;
+    expected: string;
+    actual: string;
+    differences: Array<{
+        line: number;
+        expected: string;
+        actual: string;
+    }>;
+}
+/**
+ * Compliance report
+ */
+export interface ComplianceReport {
+    generatedAt: string;
+    servers: ServerCompliance[];
+    summary: {
+        total: number;
+        compliant: number;
+        drifted: number;
+        unknown: number;
+        error: number;
+    };
+}
+/**
+ * Server compliance status
+ */
+export interface ServerCompliance {
+    server: SyncServer;
+    compliant: boolean;
+    drift?: DriftResult;
+    lastChecked: string;
+}
+/**
+ * Sync schedule
+ */
+export interface SyncSchedule {
+    id: string;
+    name: string;
+    templateId: string;
+    serverIds: string[];
+    cron?: string;
+    interval?: number;
+    enabled: boolean;
+    lastRun?: string;
+    nextRun?: string;
+}
+/**
+ * Webhook configuration
+ */
+export interface SyncWebhook {
+    id: string;
+    url: string;
+    events: Array<'sync_complete' | 'drift_detected' | 'sync_failed'>;
+    secret?: string;
+    enabled: boolean;
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    success: boolean;
+    serverId: string;
+    templateId: string;
+    syncedFiles: string[];
+    errors: string[];
+    startedAt: string;
+    completedAt: string;
+}
+/**
+ * Template sync service
+ */
+export declare class TemplateSyncService {
+    private servers;
+    private templates;
+    private serverFiles;
+    private schedules;
+    private webhooks;
+    private syncHistory;
+    private engine;
+    constructor();
+    /**
+     * Register a server for sync
+     */
+    registerServer(server: SyncServer): void;
+    /**
+     * Get server
+     */
+    getServer(id: string): SyncServer | undefined;
+    /**
+     * Get all servers
+     */
+    getServers(): SyncServer[];
+    /**
+     * Remove server
+     */
+    removeServer(id: string): boolean;
+    /**
+     * Set server file content (for drift detection)
+     */
+    setServerFile(serverId: string, path: string, content: string): void;
+    /**
+     * Get server file content
+     */
+    getServerFile(serverId: string, path: string): string | undefined;
+    /**
+     * Register template
+     */
+    registerTemplate(template: ConfigTemplate): void;
+    /**
+     * Get template
+     */
+    getTemplate(id: string): ConfigTemplate | undefined;
+    /**
+     * Check for drift on a server
+     */
+    checkDrift(serverId: string): DriftResult | null;
+    /**
+     * Check drift for all servers
+     */
+    checkAllDrift(): Map<string, DriftResult | null>;
+    /**
+     * Generate compliance report
+     */
+    generateComplianceReport(): ComplianceReport;
+    /**
+     * Sync template to server
+     * Note: Actual file writing should be done by caller
+     */
+    sync(serverId: string, templateId: string, variables: TemplateVariableValues): SyncResult;
+    /**
+     * Sync to multiple servers
+     */
+    syncMultiple(serverIds: string[], templateId: string, variables: TemplateVariableValues): SyncResult[];
+    /**
+     * Get sync history
+     */
+    getSyncHistory(limit?: number): SyncResult[];
+    /**
+     * Get sync history for server
+     */
+    getServerSyncHistory(serverId: string): SyncResult[];
+    /**
+     * Create sync schedule
+     */
+    createSchedule(schedule: SyncSchedule): void;
+    /**
+     * Get schedule
+     */
+    getSchedule(id: string): SyncSchedule | undefined;
+    /**
+     * Get all schedules
+     */
+    getSchedules(): SyncSchedule[];
+    /**
+     * Delete schedule
+     */
+    deleteSchedule(id: string): boolean;
+    /**
+     * Enable/disable schedule
+     */
+    setScheduleEnabled(id: string, enabled: boolean): boolean;
+    /**
+     * Get due schedules
+     */
+    getDueSchedules(): SyncSchedule[];
+    /**
+     * Run schedule
+     */
+    runSchedule(scheduleId: string, variables: TemplateVariableValues): SyncResult[];
+    /**
+     * Register webhook
+     */
+    registerWebhook(webhook: SyncWebhook): void;
+    /**
+     * Remove webhook
+     */
+    removeWebhook(id: string): boolean;
+    /**
+     * Get webhooks
+     */
+    getWebhooks(): SyncWebhook[];
+    /**
+     * Trigger webhooks for event
+     * Note: Actual HTTP calls should be done by caller
+     */
+    triggerWebhooks(event: SyncWebhook['events'][0], data: unknown): Array<{
+        webhook: SyncWebhook;
+        payload: unknown;
+    }>;
+    /**
+     * Get servers by template
+     */
+    getServersByTemplate(templateId: string): SyncServer[];
+    /**
+     * Get servers with drift
+     */
+    getDriftedServers(): SyncServer[];
+    /**
+     * Clear all data
+     */
+    clear(): void;
+    private calculateDifferences;
+    private createSyncResult;
+}
+/**
+ * Create a new template sync service
+ */
+export declare function createTemplateSyncService(): TemplateSyncService;
+/**
+ * Get template sync service singleton
+ */
+export declare function getTemplateSyncService(): TemplateSyncService;
+/**
+ * Reset template sync service singleton
+ */
+export declare function resetTemplateSyncService(): void;
+//# sourceMappingURL=template-sync.d.ts.map

package/dist/core/templates/template-sync.d.ts.map

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

package/dist/core/templates/template-types.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Plugin Configuration Templates Types
+ *
+ * @since v1.69.0
+ */
+/**
+ * Template category types
+ */
+export type TemplateCategory = 'general' | 'performance' | 'security' | 'economy' | 'permissions' | 'network' | 'minigames' | 'world' | 'chat' | 'admin';
+/**
+ * Variable types supported in templates
+ */
+export type TemplateVariableType = 'string' | 'number' | 'boolean' | 'select' | 'list' | 'secret';
+/**
+ * File application modes
+ */
+export type TemplateFileMode = 'replace' | 'merge' | 'append';
+/**
+ * Template variable definition
+ */
+export interface TemplateVariable {
+    name: string;
+    type: TemplateVariableType;
+    label: string;
+    description?: string;
+    default?: unknown;
+    required?: boolean;
+    options?: Array<{
+        label: string;
+        value: unknown;
+    }>;
+    validation?: string;
+}
+/**
+ * Template file definition
+ */
+export interface TemplateFile {
+    path: string;
+    content: string;
+    mode: TemplateFileMode;
+    condition?: string;
+}
+/**
+ * Template metadata
+ */
+export interface TemplateMetadata {
+    createdAt: string;
+    updatedAt: string;
+    downloads?: number;
+    rating?: number;
+    usageCount?: number;
+}
+/**
+ * Full configuration template
+ */
+export interface ConfigTemplate {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    plugins: string[];
+    minPluginVersions?: Record<string, string>;
+    files: TemplateFile[];
+    variables: TemplateVariable[];
+    extends?: string;
+    tags: string[];
+    category: TemplateCategory;
+    metadata: TemplateMetadata;
+    source: 'local' | 'builtin' | 'marketplace';
+    isOfficial?: boolean;
+}
+/**
+ * Template validation result
+ */
+export interface TemplateValidationResult {
+    valid: boolean;
+    errors: TemplateValidationError[];
+    warnings: TemplateValidationWarning[];
+}
+/**
+ * Template validation error
+ */
+export interface TemplateValidationError {
+    field: string;
+    message: string;
+    code: TemplateErrorCode;
+}
+/**
+ * Template validation warning
+ */
+export interface TemplateValidationWarning {
+    field: string;
+    message: string;
+    suggestion?: string;
+}
+/**
+ * Template error codes
+ */
+export type TemplateErrorCode = 'MISSING_REQUIRED_FIELD' | 'INVALID_ID' | 'INVALID_VERSION' | 'INVALID_VARIABLE_TYPE' | 'INVALID_VARIABLE_NAME' | 'INVALID_FILE_PATH' | 'INVALID_CONDITION' | 'INVALID_VALIDATION_REGEX' | 'DUPLICATE_VARIABLE' | 'DUPLICATE_FILE' | 'CIRCULAR_INHERITANCE' | 'MISSING_PARENT_TEMPLATE' | 'UNDEFINED_VARIABLE';
+/**
+ * Variable values for template rendering
+ */
+export type TemplateVariableValues = Record<string, unknown>;
+/**
+ * Template render result
+ */
+export interface TemplateRenderResult {
+    success: boolean;
+    files: RenderedFile[];
+    errors: RenderError[];
+}
+/**
+ * Rendered file content
+ */
+export interface RenderedFile {
+    path: string;
+    content: string;
+    mode: TemplateFileMode;
+}
+/**
+ * Render error
+ */
+export interface RenderError {
+    file: string;
+    line?: number;
+    message: string;
+    variable?: string;
+}
+/**
+ * Template search options
+ */
+export interface TemplateSearchOptions {
+    query?: string;
+    category?: TemplateCategory;
+    plugins?: string[];
+    tags?: string[];
+    source?: ConfigTemplate['source'];
+    author?: string;
+    sortBy?: 'name' | 'rating' | 'downloads' | 'updated' | 'created';
+    sortOrder?: 'asc' | 'desc';
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Template search result
+ */
+export interface TemplateSearchResult {
+    templates: ConfigTemplate[];
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Template storage configuration
+ */
+export interface TemplateStorageConfig {
+    localDir: string;
+    maxTemplates: number;
+    autoSave: boolean;
+}
+/**
+ * Template application options
+ */
+export interface TemplateApplyOptions {
+    backup?: boolean;
+    dryRun?: boolean;
+    selectedFiles?: string[];
+    skipValidation?: boolean;
+}
+/**
+ * Template application result
+ */
+export interface TemplateApplyResult {
+    success: boolean;
+    appliedFiles: string[];
+    skippedFiles: string[];
+    errors: ApplyError[];
+    backupPath?: string;
+}
+/**
+ * Apply error
+ */
+export interface ApplyError {
+    file: string;
+    message: string;
+    code: 'WRITE_FAILED' | 'MERGE_FAILED' | 'BACKUP_FAILED' | 'PERMISSION_DENIED';
+}
+/**
+ * Default storage configuration
+ */
+export declare const DEFAULT_STORAGE_CONFIG: TemplateStorageConfig;
+/**
+ * Template category display info
+ */
+export declare const CATEGORY_INFO: Record<TemplateCategory, {
+    label: string;
+    icon: string;
+}>;
+/**
+ * Valid ID pattern
+ */
+export declare const TEMPLATE_ID_PATTERN: RegExp;
+/**
+ * Valid variable name pattern
+ */
+export declare const VARIABLE_NAME_PATTERN: RegExp;
+/**
+ * Version pattern (semver)
+ */
+export declare const VERSION_PATTERN: RegExp;
+//# sourceMappingURL=template-types.d.ts.map

package/dist/core/templates/template-types.d.ts.map

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

package/dist/core/templates/template-validator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Template Validator
+ *
+ * Validates template structure, variables, and content.
+ *
+ * @since v1.69.0
+ */
+import type { ConfigTemplate, TemplateValidationResult } from './template-types.js';
+/**
+ * Template validator
+ */
+export declare class TemplateValidator {
+    private engine;
+    /**
+     * Validate a template
+     */
+    validate(template: ConfigTemplate, existingTemplates?: Map<string, ConfigTemplate>): TemplateValidationResult;
+    /**
+     * Validate variable values against template definitions
+     */
+    validateVariableValues(template: ConfigTemplate, values: Record<string, unknown>): TemplateValidationResult;
+    private validateRequiredFields;
+    private validateId;
+    private validateVersion;
+    private validateVariables;
+    private validateFiles;
+    private validateInheritance;
+    private validateVariableValue;
+}
+/**
+ * Create a new template validator
+ */
+export declare function createTemplateValidator(): TemplateValidator;
+//# sourceMappingURL=template-validator.d.ts.map

package/dist/core/templates/template-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-validator.d.ts","sourceRoot":"","sources":["../../../src/core/templates/template-validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAA4D,wBAAwB,EAA+C,MAAM,qBAAqB,CAAC;AAG3L;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAwB;IAEtC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,wBAAwB;IA+B7G;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,wBAAwB;IAmD3G,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,iBAAiB;IAqEzB,OAAO,CAAC,aAAa;IAyErB,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,qBAAqB;CAyD9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D"}

package/dist/core/tier/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tier Module Exports
+ */
+export { canAccessFeature, compareTiers, formatLimit, getTierDisplay, getTierLevel, getTierLimits, isHigherTier, meetsMinimumTier, TIER_DISPLAY, TIER_HIERARCHY, TIER_LIMITS, type TierDisplay, type TierLimits, } from './tier-config.js';
+export { checkFeatureAccess, checkTierAccess, checkUsageLimit, getNextTier, getUpgradeMessage, getUpgradeOptions, type TierGateResult, } from './tier-gate.js';
+export { getUsageService, type LimitCheckResult, type UsageReport, UsageService, type UsageStat, } from './usage-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/tier/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/tier/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,YAAY,EACZ,KAAK,SAAS,GACf,MAAM,oBAAoB,CAAC"}

package/dist/core/tier/tier-config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tier Configuration
+ *
+ * Defines tier limits, display properties, and access helpers
+ */
+import type { Tier } from '../types/auth.js';
+export interface TierLimits {
+    checksPerDay: number;
+    downloadsPerDay: number;
+    syncsPerDay: number;
+    maxServers: number;
+    cloudStorageGb: number | null;
+    customServers: boolean;
+    apiAccess: boolean;
+}
+export declare const TIER_LIMITS: Record<Tier, TierLimits>;
+export interface TierDisplay {
+    name: string;
+    color: string;
+    symbol: string;
+}
+export declare const TIER_DISPLAY: Record<Tier, TierDisplay>;
+export declare const TIER_HIERARCHY: Tier[];
+export declare function getTierLimits(tier: Tier): TierLimits;
+export declare function getTierDisplay(tier: Tier): TierDisplay;
+export declare function getTierLevel(tier: Tier): number;
+export declare function compareTiers(a: Tier, b: Tier): number;
+export declare function isHigherTier(tier: Tier, thanTier: Tier): boolean;
+export declare function meetsMinimumTier(userTier: Tier, requiredTier: Tier): boolean;
+export declare function canAccessFeature(tier: Tier, feature: keyof TierLimits): boolean;
+export declare function formatLimit(limit: number): string;
+//# sourceMappingURL=tier-config.d.ts.map

package/dist/core/tier/tier-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-config.d.ts","sourceRoot":"","sources":["../../../src/core/tier/tier-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,CAqChD,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAKlD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,IAAI,EAAmC,CAAC;AAErE,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAEpD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CAEtD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE/C;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAErD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO,CAEhE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,GAAG,OAAO,CAE5E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,UAAU,GAAG,OAAO,CAO/E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD"}