firebase-admin-edge 1.0.17 → 1.0.19

package/README.md

@@ -109,3 +109,31 @@ redirect(302, '/');
 - ✅ **Session Management** - Secure HTTP-only cookies
 - ✅ **Google OAuth** - Complete OAuth 2.0 flow
 - ✅ **Token Management** - Generate client tokens from server sessions
+
+## Currently Working On - (in no particular order)
+
+- ☐ LinkProvider (auto link?)
+- ☐ Unlink Provider
+- ☐ Create Error Classes
+- ☐ Tenants
+- ☐ App Check
+- ☐ Magic Link (auto save email?)
+- ☐ Email / Password
+- ☐ Custom oAuth Scopes
+- ☐ Get User
+- ☐ Update User
+- ☐ Delete User
+- ☐ Add / Remove Claims
+- ☐ Get all Users / Pagination
+- ☐ All Providers
+- ☐ Ban Users
+- ☐ RBAC
+
+### Other TODO Notes
+
+- Cookie Name, Cookie Options, Callback Path, Debug, TenantId
+- (enableTokenRefreshOnExpiredKidHeader ? cookieSignatureKeys ?)
+- loginWIthCodeFromURL(url)
+- next path?
+
+## Then to DB, then Storage...

package/dist/auth/auth-endpoint-errors.d.ts

@@ -0,0 +1,15 @@
+import type { FirebaseRestError } from './firebase-types.js';
+import { FirebaseEdgeError } from './errors.js';
+/**
+ * Maps Firebase REST API errors to structured FirebaseEdgeError instances.
+ * This function analyzes the Firebase error codes and HTTP status codes to determine
+ * the most appropriate structured error type.
+ *
+ * Firebase errors come with specific error codes in the message field (e.g., USER_NOT_FOUND)
+ * and additional details in the errors array with reason codes.
+ *
+ * @param firebaseError - The error object from Firebase REST API
+ * @returns A structured FirebaseEdgeError instance
+ */
+export declare function mapFirebaseError(firebaseError: FirebaseRestError['error']): FirebaseEdgeError;
+//# sourceMappingURL=auth-endpoint-errors.d.ts.map

package/dist/auth/auth-endpoint-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-endpoint-errors.d.ts","sourceRoot":"","sources":["../../src/auth/auth-endpoint-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAA6B,MAAM,aAAa,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC5B,aAAa,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAC1C,iBAAiB,CAuLnB"}

package/dist/auth/auth-endpoint-errors.js

@@ -0,0 +1,120 @@
+import { FirebaseEdgeError, FirebaseEndpointErrorInfo } from './errors.js';
+/**
+ * Maps Firebase REST API errors to structured FirebaseEdgeError instances.
+ * This function analyzes the Firebase error codes and HTTP status codes to determine
+ * the most appropriate structured error type.
+ *
+ * Firebase errors come with specific error codes in the message field (e.g., USER_NOT_FOUND)
+ * and additional details in the errors array with reason codes.
+ *
+ * @param firebaseError - The error object from Firebase REST API
+ * @returns A structured FirebaseEdgeError instance
+ */
+export function mapFirebaseError(firebaseError) {
+    const { code, message, errors } = firebaseError;
+    // First, check for specific Firebase error codes in the message field
+    const firebaseErrorCode = message?.toUpperCase?.() || '';
+    const reasonCode = errors?.[0]?.reason?.toUpperCase?.() || '';
+    // Map specific Firebase error codes to structured errors (check if message contains the error code)
+    if (firebaseErrorCode.includes('INVALID_CUSTOM_TOKEN')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INVALID_CUSTOM_TOKEN);
+    }
+    if (firebaseErrorCode.includes('INVALID_REFRESH_TOKEN') ||
+        firebaseErrorCode.includes('INVALID_GRANT')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INVALID_REFRESH_TOKEN);
+    }
+    if (firebaseErrorCode.includes('TOKEN_EXPIRED') ||
+        firebaseErrorCode.includes('CREDENTIAL_TOO_OLD_LOGIN_AGAIN')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_TOKEN_EXPIRED);
+    }
+    if (firebaseErrorCode.includes('INVALID_ID_TOKEN')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INVALID_ID_TOKEN);
+    }
+    if (firebaseErrorCode.includes('INVALID_CREDENTIAL')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INVALID_CREDENTIAL);
+    }
+    // User Management Errors
+    if (firebaseErrorCode.includes('USER_NOT_FOUND') ||
+        firebaseErrorCode.includes('EMAIL_NOT_FOUND')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_USER_NOT_FOUND);
+    }
+    if (firebaseErrorCode.includes('USER_DISABLED')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_USER_DISABLED);
+    }
+    // Permission & Access Errors
+    if (firebaseErrorCode.includes('PERMISSION_DENIED')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_PERMISSION_DENIED);
+    }
+    if (firebaseErrorCode.includes('INSUFFICIENT_PERMISSION')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INSUFFICIENT_PERMISSION);
+    }
+    // Rate Limiting & Quota Errors
+    if (firebaseErrorCode.includes('TOO_MANY_ATTEMPTS_TRY_LATER')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_TOO_MANY_REQUESTS);
+    }
+    if (firebaseErrorCode.includes('QUOTA_EXCEEDED')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_QUOTA_EXCEEDED);
+    }
+    // Provider & Configuration Errors
+    if (firebaseErrorCode.includes('OPERATION_NOT_ALLOWED')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_PROVIDER_NOT_ENABLED);
+    }
+    if (firebaseErrorCode.includes('INVALID_IDP_RESPONSE')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INVALID_PROVIDER_ID);
+    }
+    // Project & API Key Errors
+    if (firebaseErrorCode.includes('API KEY NOT VALID') ||
+        firebaseErrorCode.includes('INVALID_API_KEY')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INVALID_API_KEY);
+    }
+    // Validation Errors
+    if (firebaseErrorCode.includes('INVALID_EMAIL') ||
+        firebaseErrorCode.includes('WEAK_PASSWORD') ||
+        firebaseErrorCode.includes('EMAIL_EXISTS') ||
+        firebaseErrorCode.includes('INVALID_PASSWORD') ||
+        firebaseErrorCode.includes('MISSING_REFRESH_TOKEN') ||
+        firebaseErrorCode.includes('INVALID_GRANT_TYPE')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INVALID_ARGUMENT);
+    }
+    // Check reason codes if main message didn't match
+    if (reasonCode.includes('INVALID')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INVALID_ARGUMENT);
+    }
+    if (reasonCode.includes('FORBIDDEN')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_FORBIDDEN);
+    }
+    if (reasonCode.includes('NOTFOUND') || reasonCode.includes('NOT_FOUND')) {
+        return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_USER_NOT_FOUND);
+    }
+    // Fallback to HTTP status code mapping if no specific Firebase error code matched
+    switch (code) {
+        case 400:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INVALID_ARGUMENT);
+        case 401:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_UNAUTHORIZED);
+        case 403:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_FORBIDDEN);
+        case 404:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_USER_NOT_FOUND);
+        case 429:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_TOO_MANY_REQUESTS);
+        case 500:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_INTERNAL_ERROR);
+        case 502:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_BAD_GATEWAY);
+        case 503:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_SERVICE_UNAVAILABLE);
+        case 504:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_TIMEOUT);
+        default:
+            return new FirebaseEdgeError(FirebaseEndpointErrorInfo.ENDPOINT_UNKNOWN_ERROR, {
+                cause: new Error(message),
+                context: {
+                    firebaseCode: code,
+                    firebaseMessage: message,
+                    firebaseErrors: errors
+                }
+            });
+    }
+}
+//# sourceMappingURL=auth-endpoint-errors.js.map

package/dist/auth/auth-endpoint-errors.js.map

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