@brandtg/flapjack 1.0.0 → 1.2.0

package/dist/cache.d.ts

@@ -1,17 +1,17 @@
 import { FeatureFlagModel } from "./model.js";
 export interface Cache<T> {
-    get(key: string): T | undefined;
-    set(key: string, value: T, ttl?: number): void;
-    delete(key: string): void;
+    get(key: string): Promise<T | undefined>;
+    set(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
 }
 /**
  * Simple in-memory cache with TTL support.
  */
 export declare class InMemoryCache<T> implements Cache<T> {
     private cache;
-    get(key: string): T | undefined;
-    set(key: string, value: T, ttl?: number): void;
-    delete(key: string): void;
+    get(key: string): Promise<T | undefined>;
+    set(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
     /**
      * Clear all expired entries from the cache.
      */

package/dist/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AASD;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,KAAK,CAAoC;IAEjD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAgB/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,YAAY,IAAI,IAAI;IASpB;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,GAAG,CAAS;gBAER,EACV,KAAK,EACL,KAAK,EACL,GAAiB,GAClB,EAAE;QACD,KAAK,EAAE,gBAAgB,CAAC;QACxB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACtB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd;IAMD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBlB,eAAe,CAAC,EACpB,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,MAAM,GACP,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC;CAuBrB"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AASD;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,KAAK,CAAoC;IAE3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAgBxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,YAAY,IAAI,IAAI;IASpB;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,GAAG,CAAS;gBAER,EACV,KAAK,EACL,KAAK,EACL,GAAiB,GAClB,EAAE;QACD,KAAK,EAAE,gBAAgB,CAAC;QACxB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACtB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd;IAMD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBlB,eAAe,CAAC,EACpB,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,MAAM,GACP,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC;CAuBrB"}

package/dist/cache.js

@@ -5,7 +5,7 @@ const DEFAULT_TTL = 60 * 5; // 5 minutes
  */
 export class InMemoryCache {
     cache = new Map();
-    get(key) {
+    async get(key) {
         const entry = this.cache.get(key);
         if (!entry) {
             return undefined;
@@ -18,11 +18,11 @@ export class InMemoryCache {
         }
         return entry.value;
     }
-    set(key, value, ttl) {
+    async set(key, value, ttl) {
         const expiresAt = ttl !== undefined ? Date.now() + ttl * 1000 : undefined;
         this.cache.set(key, { value, expiresAt });
     }
-    delete(key) {
+    async delete(key) {
         this.cache.delete(key);
     }
     /**
@@ -78,7 +78,7 @@ export class FeatureFlagCache {
         // Generate cache key
         const cacheKey = this.generateCacheKey({ name, user, roles, groups });
         // Try to get from cache first
-        const cachedResult = this.cache.get(cacheKey);
+        const cachedResult = await this.cache.get(cacheKey);
         if (cachedResult !== undefined) {
             return cachedResult;
         }

package/dist/model.d.ts

@@ -89,6 +89,19 @@ export declare class FeatureFlagModel {
      * ```
      */
     getByName(name: string): Promise<FeatureFlag | null>;
+    /**
+     * Retrieves multiple feature flags by their names.
+     *
+     * @param names - Array of feature flag names to retrieve
+     * @returns Array of feature flags found (may be shorter than input if some names don't exist)
+     *
+     * @example
+     * ```typescript
+     * const flags = await model.getManyByName(["feature1", "feature2", "feature3"]);
+     * console.log(`Found ${flags.length} flags`);
+     * ```
+     */
+    getManyByName(names: string[]): Promise<FeatureFlag[]>;
     /**
      * Retrieves multiple feature flags by their IDs.
      *
@@ -161,6 +174,15 @@ export declare class FeatureFlagModel {
      * Checks if a user belongs to any of the specified groups
      */
     private isActiveForGroups;
+    /**
+     * Evaluates a feature flag for a user based on flag configuration.
+     * This is a stateless helper that performs the actual flag evaluation logic.
+     */
+    evaluateFlagForUser(flag: FeatureFlag, { user, roles, groups, }: {
+        user?: string;
+        roles?: string[];
+        groups?: string[];
+    }): Promise<boolean>;
     /**
      * Computes the hash value for a user ID using MurmurHash3.
      *
@@ -223,6 +245,59 @@ export declare class FeatureFlagModel {
         roles?: string[];
         groups?: string[];
     }): Promise<boolean>;
+    /**
+     * Checks if multiple feature flags are active for a user based on configured rules.
+     *
+     * @param params - Parameters for flag evaluation
+     * @param params.names - Optional array of feature flag names to check. If not provided, checks all flags.
+     * @param params.user - Optional user ID
+     * @param params.roles - Optional list of roles the user has
+     * @param params.groups - Optional list of groups the user belongs to
+     * @returns Record mapping flag names to their active status (true/false)
+     *
+     * @remarks
+     * This method fetches all flags in a single query for efficiency.
+     * If names is provided, only those flags are checked. Non-existent flags are marked as false.
+     * If names is not provided, all flags in the database are checked.
+     * Evaluation order for each flag (first match wins):
+     * 1. Everyone override (if set to true/false, returns immediately)
+     * 2. User ID is in the users list
+     * 3. User belongs to any group in the groups list
+     * 4. User has any role in the roles list
+     * 5. User falls within the percentage rollout (based on consistent hashing)
+     * 6. Default: returns false
+     *
+     * @example
+     * ```typescript
+     * // Check specific flags
+     * const results = await model.areActiveForUser({
+     *   names: ["feature1", "feature2", "feature3"],
+     *   user: "user_123",
+     *   roles: ["admin"],
+     *   groups: ["beta_testers"],
+     * });
+     *
+     * // Check all flags
+     * const allResults = await model.areActiveForUser({
+     *   user: "user_123",
+     *   roles: ["admin"],
+     *   groups: ["beta_testers"],
+     * });
+     *
+     * if (results["feature1"]) {
+     *   // Show feature1
+     * }
+     * if (results["feature2"]) {
+     *   // Show feature2
+     * }
+     * ```
+     */
+    areActiveForUser({ names, user, roles, groups, }: {
+        names?: string[];
+        user?: string;
+        roles?: string[];
+        groups?: string[];
+    }): Promise<Record<string, boolean>>;
 }
 type CreateGroupInput = Omit<FeatureFlagGroup, "id" | "created" | "modified">;
 type UpdateGroupChanges = Partial<Omit<FeatureFlagGroup, "id" | "created" | "modified">>;

package/dist/model.d.ts.map

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

package/dist/model.js

@@ -166,6 +166,25 @@ export class FeatureFlagModel {
             return null;
         return mapRow(res.rows[0]);
     }
+    /**
+     * Retrieves multiple feature flags by their names.
+     *
+     * @param names - Array of feature flag names to retrieve
+     * @returns Array of feature flags found (may be shorter than input if some names don't exist)
+     *
+     * @example
+     * ```typescript
+     * const flags = await model.getManyByName(["feature1", "feature2", "feature3"]);
+     * console.log(`Found ${flags.length} flags`);
+     * ```
+     */
+    async getManyByName(names) {
+        if (names.length === 0)
+            return [];
+        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE name = ANY($1)`;
+        const res = await this.db.query(sql, [names]);
+        return res.rows.map(mapRow);
+    }
     /**
      * Retrieves multiple feature flags by their IDs.
      *
@@ -300,6 +319,42 @@ export class FeatureFlagModel {
             return false;
         return flagGroups.some((group) => userGroups.includes(group));
     }
+    /**
+     * Evaluates a feature flag for a user based on flag configuration.
+     * This is a stateless helper that performs the actual flag evaluation logic.
+     */
+    async evaluateFlagForUser(flag, { user, roles, groups, }) {
+        // Everyone Override: If everyone is true or false, return that value immediately
+        if (flag.everyone !== undefined && flag.everyone !== null) {
+            return flag.everyone;
+        }
+        // User-Specific Check: If user ID is in the users array, return true
+        if (user && flag.users && flag.users.includes(user)) {
+            return true;
+        }
+        // Group Check: If any of the user's groups match any group in the groups array, return true
+        if (groups && this.isActiveForGroups(groups, flag.groups)) {
+            return true;
+        }
+        // Role Check: If any of the user's roles match any role in the roles array, return true
+        if (flag.roles && roles) {
+            for (const role of roles) {
+                if (flag.roles.includes(role)) {
+                    return true;
+                }
+            }
+        }
+        // Percentage Check: If percentage rollout applies to this user, return rollout result
+        if (user && flag.percent && flag.percent > 0) {
+            const userHash = await this.hashUserId(user);
+            const bucket = userHash % 100;
+            if (bucket < flag.percent) {
+                return true;
+            }
+        }
+        // Default: Return false
+        return false;
+    }
     /**
      * Computes the hash value for a user ID using MurmurHash3.
      *
@@ -374,36 +429,93 @@ export class FeatureFlagModel {
                 return expiredResult;
             }
         }
-        // Everyone Override: If everyone is true or false, return that value immediately
-        if (flag.everyone !== undefined && flag.everyone !== null) {
-            return flag.everyone;
-        }
-        // User-Specific Check: If user ID is in the users array, return true
-        if (user && flag.users && flag.users.includes(user)) {
-            return true;
-        }
-        // Group Check: If any of the user's groups match any group in the groups array, return true
-        if (groups && this.isActiveForGroups(groups, flag.groups)) {
-            return true;
-        }
-        // Role Check: If any of the user's roles match any role in the roles array, return true
-        if (flag.roles && roles) {
-            for (const role of roles) {
-                if (flag.roles.includes(role)) {
-                    return true;
-                }
+        return this.evaluateFlagForUser(flag, { user, roles, groups });
+    }
+    /**
+     * Checks if multiple feature flags are active for a user based on configured rules.
+     *
+     * @param params - Parameters for flag evaluation
+     * @param params.names - Optional array of feature flag names to check. If not provided, checks all flags.
+     * @param params.user - Optional user ID
+     * @param params.roles - Optional list of roles the user has
+     * @param params.groups - Optional list of groups the user belongs to
+     * @returns Record mapping flag names to their active status (true/false)
+     *
+     * @remarks
+     * This method fetches all flags in a single query for efficiency.
+     * If names is provided, only those flags are checked. Non-existent flags are marked as false.
+     * If names is not provided, all flags in the database are checked.
+     * Evaluation order for each flag (first match wins):
+     * 1. Everyone override (if set to true/false, returns immediately)
+     * 2. User ID is in the users list
+     * 3. User belongs to any group in the groups list
+     * 4. User has any role in the roles list
+     * 5. User falls within the percentage rollout (based on consistent hashing)
+     * 6. Default: returns false
+     *
+     * @example
+     * ```typescript
+     * // Check specific flags
+     * const results = await model.areActiveForUser({
+     *   names: ["feature1", "feature2", "feature3"],
+     *   user: "user_123",
+     *   roles: ["admin"],
+     *   groups: ["beta_testers"],
+     * });
+     *
+     * // Check all flags
+     * const allResults = await model.areActiveForUser({
+     *   user: "user_123",
+     *   roles: ["admin"],
+     *   groups: ["beta_testers"],
+     * });
+     *
+     * if (results["feature1"]) {
+     *   // Show feature1
+     * }
+     * if (results["feature2"]) {
+     *   // Show feature2
+     * }
+     * ```
+     */
+    async areActiveForUser({ names, user, roles, groups, }) {
+        let flags;
+        let requestedNames;
+        if (names === undefined) {
+            // If no names provided, get all flags
+            flags = await this.list();
+            requestedNames = flags.map((flag) => flag.name);
+        }
+        else {
+            // If names provided, fetch only those flags
+            flags = await this.getManyByName(names);
+            requestedNames = names;
+        }
+        const flagMap = new Map(flags.map((flag) => [flag.name, flag]));
+        const result = {};
+        for (const name of requestedNames) {
+            const flag = flagMap.get(name);
+            if (!flag) {
+                result[name] = false;
+                continue;
             }
-        }
-        // Percentage Check: If percentage rollout applies to this user, return rollout result
-        if (user && flag.percent && flag.percent > 0) {
-            const userHash = await this.hashUserId(user);
-            const bucket = userHash % 100;
-            if (bucket < flag.percent) {
-                return true;
+            // If the flag has expired, trigger event
+            if (this.eventHandlers?.onExpired &&
+                flag.expires &&
+                flag.expires <= new Date()) {
+                const expiredResult = await this.eventHandlers.onExpired({ flag });
+                if (expiredResult !== undefined) {
+                    result[name] = expiredResult;
+                    continue;
+                }
             }
+            result[name] = await this.evaluateFlagForUser(flag, {
+                user,
+                roles,
+                groups,
+            });
         }
-        // Default: Return false
-        return false;
+        return result;
     }
 }
 const GROUP_TABLE = "flapjack.feature_flag_group";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brandtg/flapjack",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "A simple feature flags library with PostgreSQL integration",
   "type": "module",
   "main": "./dist/index.js",