@autumnsgrove/groveengine 0.8.5 → 0.9.0

package/dist/config/domain-blocklist.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Loam - Domain Blocklist Configuration
+ *
+ * Part of the Loam name protection system.
+ * Comprehensive list of blocked usernames/subdomains organized by category.
+ *
+ * @see docs/specs/loam-spec.md
+ * @module domain-blocklist
+ */
+export type BlocklistReason = 'system' | 'grove_service' | 'trademark' | 'impersonation' | 'offensive' | 'fraud' | 'future_reserved';
+/**
+ * Array of valid blocklist reasons for runtime validation
+ * Use this to validate database values before type assertion
+ */
+export declare const VALID_BLOCKLIST_REASONS: BlocklistReason[];
+export interface BlocklistEntry {
+    username: string;
+    reason: BlocklistReason;
+    category?: string;
+}
+export declare const SYSTEM_RESERVED: string[];
+export declare const GROVE_SERVICES: string[];
+export declare const GROVE_TRADEMARKS: string[];
+export declare const IMPERSONATION_TERMS: string[];
+export declare const FRAUD_TERMS: string[];
+export declare const FUTURE_RESERVED: string[];
+/**
+ * Complete blocklist with all categories
+ */
+export declare const COMPLETE_BLOCKLIST: BlocklistEntry[];
+/**
+ * Fast lookup Set for validation (checks existence only)
+ */
+export declare const BLOCKED_USERNAMES: Set<string>;
+/**
+ * Fast lookup Map for validation with reason (O(1) lookup)
+ */
+export declare const BLOCKED_USERNAMES_MAP: Map<string, BlocklistReason>;
+/**
+ * Check if a username is blocked
+ * @param username - The username to check (will be lowercased)
+ * @returns The blocking reason if blocked, null if allowed
+ */
+export declare function isUsernameBlocked(username: string): BlocklistReason | null;
+/**
+ * Get a user-friendly error message for a blocked username
+ * @param reason - The blocking reason
+ * @returns A user-friendly error message
+ */
+export declare function getBlockedMessage(reason: BlocklistReason): string;
+/**
+ * Validation configuration
+ */
+export declare const VALIDATION_CONFIG: {
+    minLength: number;
+    maxLength: number;
+    pattern: RegExp;
+    patternDescription: string;
+};