@sudobility/auth_lib 0.0.5 → 0.0.9

package/dist/admin/admin-emails.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Admin email whitelist utilities
+ *
+ * Provides functions for parsing and checking admin email whitelists,
+ * typically used for bypassing rate limits and subscription checks.
+ */
+/**
+ * Parse admin emails from environment variable or string
+ *
+ * @param input - Comma-separated string of admin emails (e.g., "admin@example.com, other@example.com")
+ * @returns Array of normalized (lowercase, trimmed) email addresses
+ *
+ * @example
+ * ```typescript
+ * const adminEmails = parseAdminEmails(process.env.ADMIN_EMAILS || "");
+ * // Returns: ["admin@example.com", "other@example.com"]
+ * ```
+ */
+export declare function parseAdminEmails(input: string | undefined | null): string[];
+/**
+ * Check if an email is in the admin whitelist
+ *
+ * @param email - Email address to check
+ * @param adminEmails - Array of admin emails (from parseAdminEmails)
+ * @returns True if the email is an admin
+ *
+ * @example
+ * ```typescript
+ * const adminEmails = parseAdminEmails(process.env.ADMIN_EMAILS || "");
+ * if (isAdminEmail(user.email, adminEmails)) {
+ *   // Skip rate limiting, subscription checks, etc.
+ * }
+ * ```
+ */
+export declare function isAdminEmail(email: string | undefined | null, adminEmails: string[]): boolean;
+/**
+ * Create a cached admin email checker
+ *
+ * Parses the admin emails once and returns a checker function.
+ * Useful for middleware where you don't want to re-parse on every request.
+ *
+ * @param input - Comma-separated string of admin emails
+ * @returns Function that checks if an email is an admin
+ *
+ * @example
+ * ```typescript
+ * const isAdmin = createAdminChecker(process.env.ADMIN_EMAILS);
+ *
+ * // In middleware:
+ * if (isAdmin(user.email)) {
+ *   // Bypass checks
+ * }
+ * ```
+ */
+export declare function createAdminChecker(input: string | undefined | null): (email: string | undefined | null) => boolean;
+//# sourceMappingURL=admin-emails.d.ts.map

package/dist/admin/admin-emails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-emails.d.ts","sourceRoot":"","sources":["../../src/admin/admin-emails.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,EAAE,CAS3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAMT;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC/B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,KAAK,OAAO,CAM/C"}

package/dist/admin/admin-emails.js

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Admin email whitelist utilities
+ *
+ * Provides functions for parsing and checking admin email whitelists,
+ * typically used for bypassing rate limits and subscription checks.
+ */
+/**
+ * Parse admin emails from environment variable or string
+ *
+ * @param input - Comma-separated string of admin emails (e.g., "admin@example.com, other@example.com")
+ * @returns Array of normalized (lowercase, trimmed) email addresses
+ *
+ * @example
+ * ```typescript
+ * const adminEmails = parseAdminEmails(process.env.ADMIN_EMAILS || "");
+ * // Returns: ["admin@example.com", "other@example.com"]
+ * ```
+ */
+export function parseAdminEmails(input) {
+    if (!input) {
+        return [];
+    }
+    return input
+        .split(',')
+        .map(email => email.trim().toLowerCase())
+        .filter(email => email.length > 0 && email.includes('@'));
+}
+/**
+ * Check if an email is in the admin whitelist
+ *
+ * @param email - Email address to check
+ * @param adminEmails - Array of admin emails (from parseAdminEmails)
+ * @returns True if the email is an admin
+ *
+ * @example
+ * ```typescript
+ * const adminEmails = parseAdminEmails(process.env.ADMIN_EMAILS || "");
+ * if (isAdminEmail(user.email, adminEmails)) {
+ *   // Skip rate limiting, subscription checks, etc.
+ * }
+ * ```
+ */
+export function isAdminEmail(email, adminEmails) {
+    if (!email) {
+        return false;
+    }
+    return adminEmails.includes(email.toLowerCase());
+}
+/**
+ * Create a cached admin email checker
+ *
+ * Parses the admin emails once and returns a checker function.
+ * Useful for middleware where you don't want to re-parse on every request.
+ *
+ * @param input - Comma-separated string of admin emails
+ * @returns Function that checks if an email is an admin
+ *
+ * @example
+ * ```typescript
+ * const isAdmin = createAdminChecker(process.env.ADMIN_EMAILS);
+ *
+ * // In middleware:
+ * if (isAdmin(user.email)) {
+ *   // Bypass checks
+ * }
+ * ```
+ */
+export function createAdminChecker(input) {
+    const adminEmails = parseAdminEmails(input);
+    return (email) => {
+        return isAdminEmail(email, adminEmails);
+    };
+}

package/dist/admin/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Admin utilities exports
+ */
+export { parseAdminEmails, isAdminEmail, createAdminChecker, } from './admin-emails';
+//# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,4 @@
+/**
+ * @fileoverview Admin utilities exports
+ */
+export { parseAdminEmails, isAdminEmail, createAdminChecker, } from './admin-emails';

package/dist/index.d.ts

@@ -10,4 +10,5 @@ export { initializeFirebaseAuth, getFirebaseApp, getFirebaseAuth, getFirebaseCon
 export type { FirebaseConfig, FirebaseInitOptions, FirebaseInitResult, FirebaseAuthNetworkClientOptions, } from './config';
 export { useFirebaseAuthNetworkClient } from './hooks';
 export { getFirebaseErrorMessage, getFirebaseErrorCode, formatFirebaseError, isFirebaseAuthError, } from './utils';
+export { parseAdminEmails, isAdminEmail, createAdminChecker } from './admin';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,gCAAgC,GACjC,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,gCAAgC,GACjC,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -12,3 +12,5 @@ export { initializeFirebaseAuth, getFirebaseApp, getFirebaseAuth, getFirebaseCon
 export { useFirebaseAuthNetworkClient } from './hooks';
 // Utils
 export { getFirebaseErrorMessage, getFirebaseErrorCode, formatFirebaseError, isFirebaseAuthError, } from './utils';
+// Admin
+export { parseAdminEmails, isAdminEmail, createAdminChecker } from './admin';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/auth_lib",
-  "version": "0.0.5",
+  "version": "0.0.9",
   "description": "Firebase authentication utilities with token refresh handling",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,8 +31,8 @@
   "peerDependencies": {
     "react": "^19.2.3",
     "firebase": "^12.7.0",
-    "@sudobility/di": "^1.5.17",
-    "@sudobility/types": "^1.9.43"
+    "@sudobility/di": "^1.5.18",
+    "@sudobility/types": "^1.9.44"
   },
   "devDependencies": {
     "vitest": "^4.0.4",