@digilogiclabs/platform-core 1.6.0 → 1.8.0

package/dist/index.js

@@ -7191,6 +7191,7 @@ __export(src_exports, {
   MemoryAuditLog: () => MemoryAuditLog,
   MemoryAuth: () => MemoryAuth,
   MemoryAuthSSO: () => MemoryAuthSSO,
+  MemoryBeta: () => MemoryBeta,
   MemoryBilling: () => MemoryBilling,
   MemoryCache: () => MemoryCache,
   MemoryCompliance: () => MemoryCompliance,
@@ -7231,6 +7232,7 @@ __export(src_exports, {
   PhoneSchema: () => PhoneSchema,
   PineconeRAG: () => PineconeRAG,
   PlatformConfigSchema: () => PlatformConfigSchema,
+  PostgresBeta: () => PostgresBeta,
   PostgresDatabase: () => PostgresDatabase,
   PostgresTenant: () => PostgresTenant,
   QueueConfigSchema: () => QueueConfigSchema,
@@ -7286,6 +7288,7 @@ __export(src_exports, {
   checkEnvVars: () => checkEnvVars,
   checkRateLimit: () => checkRateLimit,
   classifyError: () => classifyError,
+  clearStoredBetaCode: () => clearStoredBetaCode,
   closeSharedRedis: () => closeSharedRedis,
   composeHookRegistries: () => composeHookRegistries,
   constantTimeEqual: () => constantTimeEqual,
@@ -7298,6 +7301,10 @@ __export(src_exports, {
   createAuditActor: () => createAuditActor,
   createAuditLogger: () => createAuditLogger,
   createAuthError: () => createAuthError,
+  createBetaClient: () => createBetaClient,
+  createBetaInvitesTable: () => createBetaInvitesTable,
+  createBetaSettingsTable: () => createBetaSettingsTable,
+  createBetaTestersTable: () => createBetaTestersTable,
   createBulkhead: () => createBulkhead,
   createCacheMiddleware: () => createCacheMiddleware,
   createCachedFallback: () => createCachedFallback,
@@ -7356,9 +7363,12 @@ __export(src_exports, {
   extractAuditRequestId: () => extractAuditRequestId,
   extractAuditUserAgent: () => extractAuditUserAgent,
   extractClientIp: () => extractClientIp,
+  fetchBetaSettings: () => fetchBetaSettings,
   filterChannelsByPreferences: () => filterChannelsByPreferences,
   formatAmount: () => formatAmount,
   generateAuditId: () => generateAuditId,
+  generateBetaCode: () => generateBetaCode,
+  generateBetaId: () => generateBetaId,
   generateChecksum: () => generateChecksum,
   generateDeliveryId: () => generateDeliveryId,
   generateErrorId: () => generateErrorId,
@@ -7388,6 +7398,7 @@ __export(src_exports, {
   getRequestId: () => getRequestId,
   getRequiredEnv: () => getRequiredEnv,
   getSharedRedis: () => getSharedRedis,
+  getStoredBetaCode: () => getStoredBetaCode,
   getTenantId: () => getTenantId,
   getTokenEndpoint: () => getTokenEndpoint,
   getTraceId: () => getTraceId,
@@ -7407,6 +7418,7 @@ __export(src_exports, {
   loadConfig: () => loadConfig,
   matchAction: () => matchAction,
   matchEventType: () => matchEventType,
+  normalizeBetaCode: () => normalizeBetaCode,
   parseKeycloakRoles: () => parseKeycloakRoles,
   raceTimeout: () => raceTimeout,
   refreshKeycloakToken: () => refreshKeycloakToken,
@@ -7420,9 +7432,11 @@ __export(src_exports, {
   sanitizeApiError: () => sanitizeApiError,
   sanitizeForEmail: () => sanitizeForEmail,
   sqlMigration: () => sqlMigration,
+  storeBetaCode: () => storeBetaCode,
   stripHtml: () => stripHtml,
   timedHealthCheck: () => timedHealthCheck,
   toHealthCheckResult: () => toHealthCheckResult,
+  validateBetaCode: () => validateBetaCode,
   validateConfig: () => validateConfig,
   validateEnvVars: () => validateEnvVars,
   withCorrelation: () => withCorrelation,
@@ -14210,6 +14224,252 @@ var MemoryCompliance = class {
   }
 };
 
+// src/interfaces/IBeta.ts
+function generateBetaCode(prefix = "BETA") {
+  const hex = Array.from(
+    { length: 8 },
+    () => Math.floor(Math.random() * 16).toString(16)
+  ).join("").toUpperCase();
+  return `${prefix}-${hex}`;
+}
+function normalizeBetaCode(code) {
+  return code.trim().toUpperCase();
+}
+function generateBetaId() {
+  return `beta_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+var MemoryBeta = class {
+  settings;
+  codes = /* @__PURE__ */ new Map();
+  testers = /* @__PURE__ */ new Map();
+  config;
+  constructor(config = {}) {
+    this.config = {
+      defaultBetaMode: config.defaultBetaMode ?? true,
+      defaultRequireInviteCode: config.defaultRequireInviteCode ?? true,
+      defaultBetaMessage: config.defaultBetaMessage ?? "We're in beta! Thanks for being an early tester.",
+      codePrefix: config.codePrefix ?? "BETA",
+      maxCodesPerBatch: config.maxCodesPerBatch ?? 50
+    };
+    this.settings = {
+      betaMode: this.config.defaultBetaMode,
+      requireInviteCode: this.config.defaultRequireInviteCode,
+      betaMessage: this.config.defaultBetaMessage
+    };
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Settings
+  // ─────────────────────────────────────────────────────────────
+  async getSettings() {
+    return { ...this.settings };
+  }
+  async updateSettings(options) {
+    if (options.betaMode !== void 0) {
+      this.settings.betaMode = options.betaMode;
+    }
+    if (options.requireInviteCode !== void 0) {
+      this.settings.requireInviteCode = options.requireInviteCode;
+    }
+    if (options.betaMessage !== void 0) {
+      this.settings.betaMessage = options.betaMessage;
+    }
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Code Management
+  // ─────────────────────────────────────────────────────────────
+  async createCodes(options) {
+    const count = Math.min(options.count ?? 1, this.config.maxCodesPerBatch);
+    const prefix = options.prefix ?? this.config.codePrefix;
+    const results = [];
+    for (let i = 0; i < count; i++) {
+      const codeStr = options.code ? normalizeBetaCode(options.code) : generateBetaCode(prefix);
+      if (this.codes.has(codeStr)) {
+        throw new Error(`Code already exists: ${codeStr}`);
+      }
+      const invite = {
+        id: generateBetaId(),
+        code: codeStr,
+        maxUses: options.maxUses ?? 1,
+        currentUses: 0,
+        expiresAt: options.expiresAt ?? null,
+        createdBy: options.createdBy,
+        notes: options.notes ?? "",
+        isActive: true,
+        createdAt: /* @__PURE__ */ new Date()
+      };
+      this.codes.set(codeStr, invite);
+      results.push(invite);
+      if (options.code) {
+        break;
+      }
+    }
+    return results;
+  }
+  async listCodes(options = {}) {
+    let codes = Array.from(this.codes.values());
+    if (options.isActive !== void 0) {
+      codes = codes.filter((c) => c.isActive === options.isActive);
+    }
+    if (options.status) {
+      const now = /* @__PURE__ */ new Date();
+      codes = codes.filter((c) => {
+        switch (options.status) {
+          case "unused":
+            return c.isActive && c.currentUses === 0;
+          case "partial":
+            return c.isActive && c.currentUses > 0 && c.currentUses < c.maxUses;
+          case "exhausted":
+            return c.currentUses >= c.maxUses;
+          case "expired":
+            return c.expiresAt !== null && c.expiresAt < now;
+          case "revoked":
+            return !c.isActive;
+          default:
+            return true;
+        }
+      });
+    }
+    codes.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    const offset = options.offset ?? 0;
+    const limit = options.limit ?? 100;
+    return codes.slice(offset, offset + limit);
+  }
+  async getCode(code) {
+    return this.codes.get(normalizeBetaCode(code)) ?? null;
+  }
+  async revokeCode(code) {
+    const normalized = normalizeBetaCode(code);
+    const invite = this.codes.get(normalized);
+    if (invite) {
+      invite.isActive = false;
+    }
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Validation & Consumption
+  // ─────────────────────────────────────────────────────────────
+  async validateCode(code) {
+    if (!this.settings.requireInviteCode) {
+      return { valid: true, message: "Invite codes are not required." };
+    }
+    const normalized = normalizeBetaCode(code);
+    const invite = this.codes.get(normalized);
+    if (!invite) {
+      return { valid: false, message: "Invalid invite code." };
+    }
+    if (!invite.isActive) {
+      return { valid: false, message: "This invite code has been revoked." };
+    }
+    if (invite.expiresAt && invite.expiresAt < /* @__PURE__ */ new Date()) {
+      return { valid: false, message: "This invite code has expired." };
+    }
+    if (invite.currentUses >= invite.maxUses) {
+      return { valid: false, message: "This invite code has reached its usage limit." };
+    }
+    return {
+      valid: true,
+      message: "Valid invite code.",
+      code: invite.code,
+      remainingUses: invite.maxUses - invite.currentUses
+    };
+  }
+  async consumeCode(code, userId) {
+    const validation = await this.validateCode(code);
+    if (!validation.valid) {
+      return { success: false, message: validation.message };
+    }
+    const normalized = normalizeBetaCode(code);
+    const invite = this.codes.get(normalized);
+    if (!invite) {
+      return { success: false, message: "Invalid invite code." };
+    }
+    invite.currentUses += 1;
+    this.testers.set(userId, {
+      userId,
+      inviteCode: invite.code,
+      isBetaTester: true,
+      betaJoinedAt: /* @__PURE__ */ new Date()
+    });
+    return { success: true, message: "Invite code consumed successfully." };
+  }
+  // ─────────────────────────────────────────────────────────────
+  // User Tracking
+  // ─────────────────────────────────────────────────────────────
+  async isBetaTester(userId) {
+    const tester = this.testers.get(userId);
+    return tester?.isBetaTester ?? false;
+  }
+  async getBetaTester(userId) {
+    return this.testers.get(userId) ?? null;
+  }
+  async listBetaTesters(options = {}) {
+    const testers = Array.from(this.testers.values()).filter((t) => t.isBetaTester).sort((a, b) => b.betaJoinedAt.getTime() - a.betaJoinedAt.getTime());
+    const offset = options.offset ?? 0;
+    const limit = options.limit ?? 100;
+    return testers.slice(offset, offset + limit);
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Analytics
+  // ─────────────────────────────────────────────────────────────
+  async getStats() {
+    const codes = Array.from(this.codes.values());
+    const activeCodes = codes.filter((c) => c.isActive);
+    const testers = Array.from(this.testers.values()).filter((t) => t.isBetaTester);
+    const joinDates = testers.map((t) => t.betaJoinedAt).sort((a, b) => a.getTime() - b.getTime());
+    return {
+      totalBetaTesters: testers.length,
+      totalCodes: codes.length,
+      activeCodes: activeCodes.length,
+      totalUses: codes.reduce((sum, c) => sum + c.currentUses, 0),
+      totalRemaining: activeCodes.reduce(
+        (sum, c) => sum + (c.maxUses - c.currentUses),
+        0
+      ),
+      firstBetaSignup: joinDates[0] ?? null,
+      latestBetaSignup: joinDates[joinDates.length - 1] ?? null
+    };
+  }
+  async getCodeUsageReports() {
+    return Array.from(this.codes.values()).sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime()).map((c) => ({
+      code: c.code,
+      notes: c.notes,
+      maxUses: c.maxUses,
+      currentUses: c.currentUses,
+      remainingUses: c.maxUses - c.currentUses,
+      usagePercent: c.maxUses > 0 ? Math.round(c.currentUses / c.maxUses * 100) : 0,
+      isActive: c.isActive,
+      expiresAt: c.expiresAt,
+      createdAt: c.createdAt
+    }));
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Health
+  // ─────────────────────────────────────────────────────────────
+  async healthCheck() {
+    return true;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Testing Helpers
+  // ─────────────────────────────────────────────────────────────
+  /** Clear all data (for testing) */
+  clear() {
+    this.codes.clear();
+    this.testers.clear();
+    this.settings = {
+      betaMode: this.config.defaultBetaMode,
+      requireInviteCode: this.config.defaultRequireInviteCode,
+      betaMessage: this.config.defaultBetaMessage
+    };
+  }
+  /** Get the number of stored codes */
+  get codeCount() {
+    return this.codes.size;
+  }
+  /** Get the number of beta testers */
+  get testerCount() {
+    return this.testers.size;
+  }
+};
+
 // src/index.ts
 init_IAI();
 init_IRAG();
@@ -16665,8 +16925,8 @@ var MemoryRateLimiterStorage = class {
     const cleanupIntervalMs = options.cleanupIntervalMs ?? 6e4;
     this.cleanupInterval = setInterval(() => {
       const now = Date.now();
-      for (const [key, window] of this.windows) {
-        if (window.resetAt < now) {
+      for (const [key, window2] of this.windows) {
+        if (window2.resetAt < now) {
           this.windows.delete(key);
         }
       }
@@ -16677,20 +16937,20 @@ var MemoryRateLimiterStorage = class {
   }
   async increment(key, windowMs) {
     const now = Date.now();
-    let window = this.windows.get(key);
-    if (!window || window.resetAt < now) {
-      window = { count: 0, resetAt: now + windowMs };
-      this.windows.set(key, window);
+    let window2 = this.windows.get(key);
+    if (!window2 || window2.resetAt < now) {
+      window2 = { count: 0, resetAt: now + windowMs };
+      this.windows.set(key, window2);
     }
-    window.count++;
-    return [window.count, window.resetAt];
+    window2.count++;
+    return [window2.count, window2.resetAt];
   }
   async get(key) {
-    const window = this.windows.get(key);
-    if (!window || window.resetAt < Date.now()) {
+    const window2 = this.windows.get(key);
+    if (!window2 || window2.resetAt < Date.now()) {
       return null;
     }
-    return window;
+    return window2;
   }
   /**
    * Clear all windows (for testing)
@@ -18277,7 +18537,11 @@ function buildKeycloakCallbacks(config) {
      * Compatible with Auth.js v5 JWT callback signature.
      */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async jwt({ token, user, account }) {
+    async jwt({
+      token,
+      user,
+      account
+    }) {
       if (user) {
         token.id = token.sub ?? user.id;
       }
@@ -18946,6 +19210,119 @@ function createAuditLogger(options = {}) {
   return { log, createTimedAudit };
 }
 
+// src/auth/beta-client.ts
+var DEFAULT_CONFIG = {
+  baseUrl: "",
+  settingsEndpoint: "/api/beta-settings",
+  validateEndpoint: "/api/validate-beta-code",
+  storageKey: "beta_code",
+  failSafeDefaults: {
+    betaMode: true,
+    requireInviteCode: true,
+    betaMessage: ""
+  }
+};
+function createBetaClient(config = {}) {
+  const cfg = {
+    ...DEFAULT_CONFIG,
+    ...config,
+    failSafeDefaults: {
+      ...DEFAULT_CONFIG.failSafeDefaults,
+      ...config.failSafeDefaults
+    }
+  };
+  return {
+    fetchSettings: () => fetchBetaSettings(cfg),
+    validateCode: (code) => validateBetaCode(code, cfg),
+    storeCode: (code) => storeBetaCode(code, cfg),
+    getStoredCode: () => getStoredBetaCode(cfg),
+    clearStoredCode: () => clearStoredBetaCode(cfg)
+  };
+}
+async function fetchBetaSettings(config = {}) {
+  const cfg = { ...DEFAULT_CONFIG, ...config };
+  try {
+    const response = await fetch(
+      `${cfg.baseUrl}${cfg.settingsEndpoint}`,
+      {
+        method: "GET",
+        headers: { "Content-Type": "application/json" },
+        cache: "no-store"
+      }
+    );
+    if (!response.ok) {
+      throw new Error(`Failed to fetch beta settings: ${response.status}`);
+    }
+    const data = await response.json();
+    return {
+      betaMode: data.betaMode ?? cfg.failSafeDefaults.betaMode ?? true,
+      requireInviteCode: data.requireInviteCode ?? cfg.failSafeDefaults.requireInviteCode ?? true,
+      betaMessage: data.betaMessage ?? cfg.failSafeDefaults.betaMessage ?? ""
+    };
+  } catch (error) {
+    console.error("Error fetching beta settings:", error);
+    return {
+      betaMode: cfg.failSafeDefaults.betaMode ?? true,
+      requireInviteCode: cfg.failSafeDefaults.requireInviteCode ?? true,
+      betaMessage: cfg.failSafeDefaults.betaMessage ?? ""
+    };
+  }
+}
+async function validateBetaCode(code, config = {}) {
+  const cfg = { ...DEFAULT_CONFIG, ...config };
+  if (!code || code.trim().length < 3) {
+    return {
+      valid: false,
+      message: "Please enter a valid invite code."
+    };
+  }
+  try {
+    const response = await fetch(
+      `${cfg.baseUrl}${cfg.validateEndpoint}`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ code: code.trim().toUpperCase() })
+      }
+    );
+    if (response.status === 429) {
+      return {
+        valid: false,
+        message: "Too many attempts. Please try again later."
+      };
+    }
+    if (!response.ok) {
+      throw new Error(`Validation request failed: ${response.status}`);
+    }
+    return await response.json();
+  } catch (error) {
+    console.error("Error validating invite code:", error);
+    return {
+      valid: false,
+      message: "Unable to validate code. Please try again."
+    };
+  }
+}
+function storeBetaCode(code, config = {}) {
+  const key = config.storageKey ?? DEFAULT_CONFIG.storageKey;
+  if (typeof window !== "undefined") {
+    sessionStorage.setItem(key, code.trim().toUpperCase());
+  }
+}
+function getStoredBetaCode(config = {}) {
+  const key = config.storageKey ?? DEFAULT_CONFIG.storageKey;
+  if (typeof window !== "undefined") {
+    return sessionStorage.getItem(key);
+  }
+  return null;
+}
+function clearStoredBetaCode(config = {}) {
+  const key = config.storageKey ?? DEFAULT_CONFIG.storageKey;
+  if (typeof window !== "undefined") {
+    sessionStorage.removeItem(key);
+  }
+}
+
 // src/env.ts
 function getRequiredEnv(key) {
   const value = process.env[key];
@@ -30997,6 +31374,498 @@ function generateId2() {
   return (0, import_crypto38.randomBytes)(8).toString("hex") + Date.now().toString(36);
 }
 
+// src/adapters/postgres-beta/PostgresBeta.ts
+function mapRowToInvite(row) {
+  return {
+    id: row.id,
+    code: row.code,
+    maxUses: row.max_uses,
+    currentUses: row.current_uses,
+    expiresAt: row.expires_at ? new Date(row.expires_at) : null,
+    createdBy: row.created_by,
+    notes: row.notes ?? "",
+    isActive: row.is_active,
+    createdAt: new Date(row.created_at)
+  };
+}
+function mapRowToTester(row) {
+  return {
+    userId: row.user_id,
+    inviteCode: row.invite_code,
+    isBetaTester: row.is_beta_tester,
+    betaJoinedAt: new Date(row.beta_joined_at)
+  };
+}
+var PostgresBeta = class {
+  pool;
+  schema;
+  settingsSource;
+  envPrefix;
+  staticCodes;
+  config;
+  constructor(pgConfig) {
+    this.pool = pgConfig.pool;
+    this.schema = pgConfig.schema ?? "public";
+    this.settingsSource = pgConfig.settingsSource ?? "database";
+    this.envPrefix = pgConfig.envPrefix ?? "BETA";
+    this.staticCodes = new Set(
+      (pgConfig.staticCodes ?? []).map((c) => normalizeBetaCode(c))
+    );
+    this.config = {
+      defaultBetaMode: pgConfig.defaultBetaMode ?? true,
+      defaultRequireInviteCode: pgConfig.defaultRequireInviteCode ?? true,
+      defaultBetaMessage: pgConfig.defaultBetaMessage ?? "We're in beta! Thanks for being an early tester.",
+      codePrefix: pgConfig.codePrefix ?? "BETA",
+      maxCodesPerBatch: pgConfig.maxCodesPerBatch ?? 50
+    };
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Table helpers
+  // ─────────────────────────────────────────────────────────────
+  t(table) {
+    return `${this.schema}.${table}`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Initialization
+  // ─────────────────────────────────────────────────────────────
+  /**
+   * Initialize beta tables. Call once at app startup.
+   * Creates tables if they don't exist and seeds default settings.
+   */
+  async initialize() {
+    const client = await this.pool.connect();
+    try {
+      await client.query(`
+        CREATE TABLE IF NOT EXISTS ${this.t("beta_settings")} (
+          key VARCHAR(100) PRIMARY KEY,
+          value TEXT NOT NULL,
+          description TEXT,
+          updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+          updated_by VARCHAR(255)
+        )
+      `);
+      await client.query(`
+        INSERT INTO ${this.t("beta_settings")} (key, value, description) VALUES
+          ('beta_mode', $1, 'Whether the app is in beta mode'),
+          ('require_invite_code', $2, 'Whether an invite code is required to sign up'),
+          ('beta_message', $3, 'Message displayed during beta')
+        ON CONFLICT (key) DO NOTHING
+      `, [
+        String(this.config.defaultBetaMode),
+        String(this.config.defaultRequireInviteCode),
+        this.config.defaultBetaMessage
+      ]);
+      await client.query(`
+        CREATE TABLE IF NOT EXISTS ${this.t("beta_invites")} (
+          id VARCHAR(255) PRIMARY KEY,
+          code VARCHAR(100) NOT NULL UNIQUE,
+          max_uses INTEGER NOT NULL DEFAULT 1,
+          current_uses INTEGER NOT NULL DEFAULT 0,
+          expires_at TIMESTAMP WITH TIME ZONE,
+          created_by VARCHAR(255) NOT NULL,
+          notes TEXT DEFAULT '',
+          is_active BOOLEAN NOT NULL DEFAULT true,
+          created_at TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
+          CONSTRAINT chk_beta_uses CHECK (current_uses <= max_uses)
+        )
+      `);
+      await client.query(`
+        CREATE INDEX IF NOT EXISTS idx_beta_invites_code_active
+          ON ${this.t("beta_invites")}(code) WHERE is_active = true
+      `);
+      await client.query(`
+        CREATE TABLE IF NOT EXISTS ${this.t("beta_testers")} (
+          user_id VARCHAR(255) PRIMARY KEY,
+          invite_code VARCHAR(100) NOT NULL,
+          is_beta_tester BOOLEAN NOT NULL DEFAULT true,
+          beta_joined_at TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW()
+        )
+      `);
+      await client.query(`
+        CREATE INDEX IF NOT EXISTS idx_beta_testers_active
+          ON ${this.t("beta_testers")}(is_beta_tester, beta_joined_at DESC)
+          WHERE is_beta_tester = true
+      `);
+    } finally {
+      client.release();
+    }
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Settings
+  // ─────────────────────────────────────────────────────────────
+  async getSettings() {
+    if (this.settingsSource === "env") {
+      return this.getEnvSettings();
+    }
+    const result = await this.pool.query(
+      `SELECT key, value FROM ${this.t("beta_settings")} WHERE key IN ('beta_mode', 'require_invite_code', 'beta_message')`
+    );
+    const settings = {};
+    for (const row of result.rows) {
+      settings[row.key] = row.value;
+    }
+    return {
+      betaMode: settings["beta_mode"] !== "false",
+      requireInviteCode: settings["require_invite_code"] !== "false",
+      betaMessage: settings["beta_message"] ?? this.config.defaultBetaMessage
+    };
+  }
+  getEnvSettings() {
+    const prefix = this.envPrefix;
+    return {
+      betaMode: process.env[`${prefix}_MODE`] !== "false",
+      requireInviteCode: process.env[`${prefix}_REQUIRE_INVITE_CODE`] !== "false",
+      betaMessage: process.env[`${prefix}_MESSAGE`] ?? this.config.defaultBetaMessage
+    };
+  }
+  async updateSettings(options) {
+    if (this.settingsSource === "env") {
+      return;
+    }
+    const client = await this.pool.connect();
+    try {
+      const updates = [];
+      if (options.betaMode !== void 0) {
+        updates.push({ key: "beta_mode", value: String(options.betaMode) });
+      }
+      if (options.requireInviteCode !== void 0) {
+        updates.push({ key: "require_invite_code", value: String(options.requireInviteCode) });
+      }
+      if (options.betaMessage !== void 0) {
+        updates.push({ key: "beta_message", value: options.betaMessage });
+      }
+      for (const { key, value } of updates) {
+        await client.query(
+          `UPDATE ${this.t("beta_settings")} SET value = $1, updated_at = NOW(), updated_by = $2 WHERE key = $3`,
+          [value, options.updatedBy ?? "system", key]
+        );
+      }
+    } finally {
+      client.release();
+    }
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Code Management
+  // ─────────────────────────────────────────────────────────────
+  async createCodes(options) {
+    const count = Math.min(options.count ?? 1, this.config.maxCodesPerBatch);
+    const prefix = options.prefix ?? this.config.codePrefix;
+    const results = [];
+    const client = await this.pool.connect();
+    try {
+      for (let i = 0; i < count; i++) {
+        const codeStr = options.code ? normalizeBetaCode(options.code) : generateBetaCode(prefix);
+        const id = generateBetaId();
+        let attempts = 0;
+        let inserted = false;
+        let currentCode = codeStr;
+        while (!inserted && attempts < 5) {
+          try {
+            const result = await client.query(
+              `INSERT INTO ${this.t("beta_invites")} (id, code, max_uses, expires_at, created_by, notes)
+               VALUES ($1, $2, $3, $4, $5, $6)
+               RETURNING *`,
+              [
+                id,
+                currentCode,
+                options.maxUses ?? 1,
+                options.expiresAt ?? null,
+                options.createdBy,
+                options.notes ?? ""
+              ]
+            );
+            const row = result.rows[0];
+            if (row) results.push(mapRowToInvite(row));
+            inserted = true;
+          } catch (err) {
+            const pgErr = err;
+            if (pgErr.code === "23505" && !options.code) {
+              currentCode = generateBetaCode(prefix);
+              attempts++;
+            } else {
+              throw err;
+            }
+          }
+        }
+        if (!inserted) {
+          throw new Error(`Failed to generate unique code after ${attempts} attempts`);
+        }
+        if (options.code) break;
+      }
+    } finally {
+      client.release();
+    }
+    return results;
+  }
+  async listCodes(options = {}) {
+    const conditions = [];
+    const params = [];
+    let paramIdx = 1;
+    if (options.isActive !== void 0) {
+      conditions.push(`is_active = $${paramIdx++}`);
+      params.push(options.isActive);
+    }
+    if (options.status) {
+      switch (options.status) {
+        case "unused":
+          conditions.push("is_active = true");
+          conditions.push("current_uses = 0");
+          break;
+        case "partial":
+          conditions.push("is_active = true");
+          conditions.push("current_uses > 0");
+          conditions.push("current_uses < max_uses");
+          break;
+        case "exhausted":
+          conditions.push("current_uses >= max_uses");
+          break;
+        case "expired":
+          conditions.push("expires_at IS NOT NULL");
+          conditions.push("expires_at < NOW()");
+          break;
+        case "revoked":
+          conditions.push("is_active = false");
+          break;
+      }
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const limit = options.limit ?? 100;
+    const offset = options.offset ?? 0;
+    const result = await this.pool.query(
+      `SELECT * FROM ${this.t("beta_invites")} ${where}
+       ORDER BY created_at DESC
+       LIMIT $${paramIdx++} OFFSET $${paramIdx++}`,
+      [...params, limit, offset]
+    );
+    return result.rows.map(mapRowToInvite);
+  }
+  async getCode(code) {
+    const normalized = normalizeBetaCode(code);
+    const result = await this.pool.query(
+      `SELECT * FROM ${this.t("beta_invites")} WHERE code = $1`,
+      [normalized]
+    );
+    const row = result.rows[0];
+    if (!row) return null;
+    return mapRowToInvite(row);
+  }
+  async revokeCode(code) {
+    const normalized = normalizeBetaCode(code);
+    await this.pool.query(
+      `UPDATE ${this.t("beta_invites")} SET is_active = false WHERE code = $1`,
+      [normalized]
+    );
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Validation & Consumption
+  // ─────────────────────────────────────────────────────────────
+  async validateCode(code) {
+    const settings = await this.getSettings();
+    if (!settings.requireInviteCode) {
+      return { valid: true, message: "Invite codes are not required." };
+    }
+    const normalized = normalizeBetaCode(code);
+    if (this.staticCodes.has(normalized)) {
+      return {
+        valid: true,
+        message: "Valid invite code.",
+        code: normalized
+      };
+    }
+    const result = await this.pool.query(
+      `SELECT * FROM ${this.t("beta_invites")}
+       WHERE code = $1
+         AND is_active = true
+         AND (expires_at IS NULL OR expires_at > NOW())
+         AND current_uses < max_uses`,
+      [normalized]
+    );
+    if (result.rows.length === 0) {
+      const exists = await this.pool.query(
+        `SELECT is_active, expires_at, current_uses, max_uses FROM ${this.t("beta_invites")} WHERE code = $1`,
+        [normalized]
+      );
+      if (exists.rows.length === 0) {
+        return { valid: false, message: "Invalid invite code." };
+      }
+      const existRow = exists.rows[0];
+      if (!existRow) {
+        return { valid: false, message: "Invalid invite code." };
+      }
+      if (!existRow.is_active) {
+        return { valid: false, message: "This invite code has been revoked." };
+      }
+      if (existRow.expires_at && new Date(existRow.expires_at) < /* @__PURE__ */ new Date()) {
+        return { valid: false, message: "This invite code has expired." };
+      }
+      if (existRow.current_uses >= existRow.max_uses) {
+        return { valid: false, message: "This invite code has reached its usage limit." };
+      }
+      return { valid: false, message: "Invalid invite code." };
+    }
+    const invite = result.rows[0];
+    if (!invite) {
+      return { valid: false, message: "Invalid invite code." };
+    }
+    return {
+      valid: true,
+      message: "Valid invite code.",
+      code: invite.code,
+      remainingUses: invite.max_uses - invite.current_uses
+    };
+  }
+  async consumeCode(code, userId) {
+    const normalized = normalizeBetaCode(code);
+    if (this.staticCodes.has(normalized)) {
+      await this.tagBetaTester(userId, normalized);
+      return { success: true, message: "Invite code consumed successfully." };
+    }
+    const client = await this.pool.connect();
+    try {
+      await client.query("BEGIN");
+      const result = await client.query(
+        `SELECT * FROM ${this.t("beta_invites")}
+         WHERE code = $1
+           AND is_active = true
+           AND (expires_at IS NULL OR expires_at > NOW())
+           AND current_uses < max_uses
+         FOR UPDATE`,
+        [normalized]
+      );
+      if (result.rows.length === 0) {
+        await client.query("ROLLBACK");
+        return { success: false, message: "Invalid or exhausted invite code." };
+      }
+      await client.query(
+        `UPDATE ${this.t("beta_invites")} SET current_uses = current_uses + 1 WHERE code = $1`,
+        [normalized]
+      );
+      await client.query(
+        `INSERT INTO ${this.t("beta_testers")} (user_id, invite_code, is_beta_tester, beta_joined_at)
+         VALUES ($1, $2, true, NOW())
+         ON CONFLICT (user_id) DO UPDATE SET invite_code = $2, is_beta_tester = true, beta_joined_at = NOW()`,
+        [userId, normalized]
+      );
+      await client.query("COMMIT");
+      return { success: true, message: "Invite code consumed successfully." };
+    } catch (error) {
+      await client.query("ROLLBACK");
+      throw error;
+    } finally {
+      client.release();
+    }
+  }
+  async tagBetaTester(userId, code) {
+    await this.pool.query(
+      `INSERT INTO ${this.t("beta_testers")} (user_id, invite_code, is_beta_tester, beta_joined_at)
+       VALUES ($1, $2, true, NOW())
+       ON CONFLICT (user_id) DO UPDATE SET invite_code = $2, is_beta_tester = true, beta_joined_at = NOW()`,
+      [userId, code]
+    );
+  }
+  // ─────────────────────────────────────────────────────────────
+  // User Tracking
+  // ─────────────────────────────────────────────────────────────
+  async isBetaTester(userId) {
+    const result = await this.pool.query(
+      `SELECT is_beta_tester FROM ${this.t("beta_testers")} WHERE user_id = $1 AND is_beta_tester = true`,
+      [userId]
+    );
+    return result.rows.length > 0;
+  }
+  async getBetaTester(userId) {
+    const result = await this.pool.query(
+      `SELECT * FROM ${this.t("beta_testers")} WHERE user_id = $1`,
+      [userId]
+    );
+    const row = result.rows[0];
+    if (!row) return null;
+    return mapRowToTester(row);
+  }
+  async listBetaTesters(options = {}) {
+    const limit = options.limit ?? 100;
+    const offset = options.offset ?? 0;
+    const result = await this.pool.query(
+      `SELECT * FROM ${this.t("beta_testers")}
+       WHERE is_beta_tester = true
+       ORDER BY beta_joined_at DESC
+       LIMIT $1 OFFSET $2`,
+      [limit, offset]
+    );
+    return result.rows.map(mapRowToTester);
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Analytics
+  // ─────────────────────────────────────────────────────────────
+  async getStats() {
+    const [testersResult, codesResult] = await Promise.all([
+      this.pool.query(
+        `SELECT
+           COUNT(*) as total,
+           MIN(beta_joined_at) as first_signup,
+           MAX(beta_joined_at) as latest_signup
+         FROM ${this.t("beta_testers")}
+         WHERE is_beta_tester = true`
+      ),
+      this.pool.query(
+        `SELECT
+           COUNT(*) as total_codes,
+           COUNT(*) FILTER (WHERE is_active = true) as active_codes,
+           COALESCE(SUM(current_uses), 0) as total_uses,
+           COALESCE(SUM(CASE WHEN is_active = true THEN max_uses - current_uses ELSE 0 END), 0) as total_remaining
+         FROM ${this.t("beta_invites")}`
+      )
+    ]);
+    const tRow = testersResult.rows[0] ?? {};
+    const cRow = codesResult.rows[0] ?? {};
+    return {
+      totalBetaTesters: Number(tRow.total ?? 0),
+      totalCodes: Number(cRow.total_codes ?? 0),
+      activeCodes: Number(cRow.active_codes ?? 0),
+      totalUses: Number(cRow.total_uses ?? 0),
+      totalRemaining: Number(cRow.total_remaining ?? 0),
+      firstBetaSignup: tRow.first_signup ? new Date(tRow.first_signup) : null,
+      latestBetaSignup: tRow.latest_signup ? new Date(tRow.latest_signup) : null
+    };
+  }
+  async getCodeUsageReports() {
+    const result = await this.pool.query(
+      `SELECT
+         code, notes, max_uses, current_uses,
+         (max_uses - current_uses) as remaining_uses,
+         CASE WHEN max_uses > 0
+           THEN ROUND((current_uses::numeric / max_uses) * 100)
+           ELSE 0
+         END as usage_percent,
+         is_active, expires_at, created_at
+       FROM ${this.t("beta_invites")}
+       ORDER BY created_at DESC`
+    );
+    return result.rows.map((row) => ({
+      code: row.code,
+      notes: row.notes ?? "",
+      maxUses: row.max_uses,
+      currentUses: row.current_uses,
+      remainingUses: Number(row.remaining_uses ?? 0),
+      usagePercent: Number(row.usage_percent ?? 0),
+      isActive: row.is_active,
+      expiresAt: row.expires_at ? new Date(row.expires_at) : null,
+      createdAt: new Date(row.created_at)
+    }));
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Health
+  // ─────────────────────────────────────────────────────────────
+  async healthCheck() {
+    try {
+      await this.pool.query("SELECT 1");
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+
 // src/app-logger.ts
 var LEVEL_PRIORITY2 = {
   debug: 0,
@@ -31173,7 +32042,7 @@ async function closeSharedRedis() {
 }
 
 // src/migrations/Migrator.ts
-var DEFAULT_CONFIG = {
+var DEFAULT_CONFIG2 = {
   tableName: "_migrations",
   schema: "public",
   lockTimeout: 60,
@@ -31200,7 +32069,7 @@ var Migrator = class {
   locked = false;
   constructor(db, config = {}) {
     this.db = db;
-    this.config = { ...DEFAULT_CONFIG, ...config };
+    this.config = { ...DEFAULT_CONFIG2, ...config };
   }
   /**
    * Get the fully qualified migration table name
@@ -31896,6 +32765,67 @@ var createSsoSessionsTable = {
   `,
   down: "DROP TABLE IF EXISTS sso_sessions CASCADE"
 };
+var createBetaSettingsTable = {
+  version: "20241217_009",
+  name: "create_beta_settings_table",
+  up: `
+    CREATE TABLE IF NOT EXISTS beta_settings (
+      key VARCHAR(100) PRIMARY KEY,
+      value TEXT NOT NULL,
+      description TEXT,
+      updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+      updated_by VARCHAR(255)
+    );
+
+    INSERT INTO beta_settings (key, value, description) VALUES
+      ('beta_mode', 'true', 'Whether the app is in beta mode'),
+      ('require_invite_code', 'true', 'Whether an invite code is required to sign up'),
+      ('beta_message', 'We''re in beta! Thanks for being an early tester.', 'Message displayed during beta')
+    ON CONFLICT (key) DO NOTHING;
+  `,
+  down: "DROP TABLE IF EXISTS beta_settings CASCADE"
+};
+var createBetaInvitesTable = {
+  version: "20241217_010",
+  name: "create_beta_invites_table",
+  up: `
+    CREATE TABLE IF NOT EXISTS beta_invites (
+      id VARCHAR(255) PRIMARY KEY,
+      code VARCHAR(100) NOT NULL UNIQUE,
+      max_uses INTEGER NOT NULL DEFAULT 1,
+      current_uses INTEGER NOT NULL DEFAULT 0,
+      expires_at TIMESTAMP WITH TIME ZONE,
+      created_by VARCHAR(255) NOT NULL,
+      notes TEXT DEFAULT '',
+      is_active BOOLEAN NOT NULL DEFAULT true,
+      created_at TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
+      CONSTRAINT chk_beta_uses CHECK (current_uses <= max_uses)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_beta_invites_code_active
+      ON beta_invites(code) WHERE is_active = true;
+    CREATE INDEX IF NOT EXISTS idx_beta_invites_active
+      ON beta_invites(is_active, created_at DESC);
+  `,
+  down: "DROP TABLE IF EXISTS beta_invites CASCADE"
+};
+var createBetaTestersTable = {
+  version: "20241217_011",
+  name: "create_beta_testers_table",
+  up: `
+    CREATE TABLE IF NOT EXISTS beta_testers (
+      user_id VARCHAR(255) PRIMARY KEY,
+      invite_code VARCHAR(100) NOT NULL REFERENCES beta_invites(code) ON DELETE SET NULL,
+      is_beta_tester BOOLEAN NOT NULL DEFAULT true,
+      beta_joined_at TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW()
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_beta_testers_active
+      ON beta_testers(is_beta_tester, beta_joined_at DESC)
+      WHERE is_beta_tester = true;
+  `,
+  down: "DROP TABLE IF EXISTS beta_testers CASCADE"
+};
 var enterpriseMigrations = [
   createSsoOidcConfigsTable,
   createDomainVerificationsTable,
@@ -31904,7 +32834,10 @@ var enterpriseMigrations = [
   createTenantMembersTable,
   createTenantInvitationsTable,
   createTenantUsageTable,
-  createSsoSessionsTable
+  createSsoSessionsTable,
+  createBetaSettingsTable,
+  createBetaInvitesTable,
+  createBetaTestersTable
 ];
 function getEnterpriseMigrations(features) {
   const migrations = [];
@@ -31924,6 +32857,13 @@ function getEnterpriseMigrations(features) {
       createTenantUsageTable
     );
   }
+  if (features.beta) {
+    migrations.push(
+      createBetaSettingsTable,
+      createBetaInvitesTable,
+      createBetaTestersTable
+    );
+  }
   return migrations;
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -31986,6 +32926,7 @@ function getEnterpriseMigrations(features) {
   MemoryAuditLog,
   MemoryAuth,
   MemoryAuthSSO,
+  MemoryBeta,
   MemoryBilling,
   MemoryCache,
   MemoryCompliance,
@@ -32026,6 +32967,7 @@ function getEnterpriseMigrations(features) {
   PhoneSchema,
   PineconeRAG,
   PlatformConfigSchema,
+  PostgresBeta,
   PostgresDatabase,
   PostgresTenant,
   QueueConfigSchema,
@@ -32081,6 +33023,7 @@ function getEnterpriseMigrations(features) {
   checkEnvVars,
   checkRateLimit,
   classifyError,
+  clearStoredBetaCode,
   closeSharedRedis,
   composeHookRegistries,
   constantTimeEqual,
@@ -32093,6 +33036,10 @@ function getEnterpriseMigrations(features) {
   createAuditActor,
   createAuditLogger,
   createAuthError,
+  createBetaClient,
+  createBetaInvitesTable,
+  createBetaSettingsTable,
+  createBetaTestersTable,
   createBulkhead,
   createCacheMiddleware,
   createCachedFallback,
@@ -32151,9 +33098,12 @@ function getEnterpriseMigrations(features) {
   extractAuditRequestId,
   extractAuditUserAgent,
   extractClientIp,
+  fetchBetaSettings,
   filterChannelsByPreferences,
   formatAmount,
   generateAuditId,
+  generateBetaCode,
+  generateBetaId,
   generateChecksum,
   generateDeliveryId,
   generateErrorId,
@@ -32183,6 +33133,7 @@ function getEnterpriseMigrations(features) {
   getRequestId,
   getRequiredEnv,
   getSharedRedis,
+  getStoredBetaCode,
   getTenantId,
   getTokenEndpoint,
   getTraceId,
@@ -32202,6 +33153,7 @@ function getEnterpriseMigrations(features) {
   loadConfig,
   matchAction,
   matchEventType,
+  normalizeBetaCode,
   parseKeycloakRoles,
   raceTimeout,
   refreshKeycloakToken,
@@ -32215,9 +33167,11 @@ function getEnterpriseMigrations(features) {
   sanitizeApiError,
   sanitizeForEmail,
   sqlMigration,
+  storeBetaCode,
   stripHtml,
   timedHealthCheck,
   toHealthCheckResult,
+  validateBetaCode,
   validateConfig,
   validateEnvVars,
   withCorrelation,