@dereekb/firebase-server 13.7.0 → 13.8.0

package/src/lib/auth/auth.service.error.d.ts

@@ -65,3 +65,32 @@ export declare class FirebaseServerAuthNewUserSendSetupDetailsThrottleError exte
 export declare class FirebaseServerAuthNewUserSendSetupDetailsSendOnceError extends BaseError {
     constructor();
 }
+/**
+ * Thrown by {@link AbstractFirebaseServerUserPasswordResetService.sendResetContent} when the user
+ * has no active password reset claims, meaning no reset has been initiated or it has already been completed.
+ */
+export declare class FirebaseServerAuthPasswordResetNoResetConfigError extends BaseError {
+    constructor();
+}
+/**
+ * Thrown by {@link AbstractFirebaseServerUserPasswordResetService.sendResetContent} when the user
+ * was recently sent reset content and the throttle window has not elapsed.
+ */
+export declare class FirebaseServerAuthPasswordResetThrottleError extends BaseError {
+    readonly lastSentAt: Date;
+    constructor(lastSentAt: Date);
+}
+/**
+ * Thrown by {@link AbstractFirebaseServerUserPasswordResetService.sendResetContent} when the user
+ * has already been sent reset content and the `sendResetDetailsOnce` option was enabled.
+ */
+export declare class FirebaseServerAuthPasswordResetSendOnceError extends BaseError {
+    constructor();
+}
+/**
+ * Thrown by {@link AbstractFirebaseServerUserPasswordResetService.completePasswordReset} when the
+ * provided reset code does not match the one stored in the user's claims, or no reset is active.
+ */
+export declare class FirebaseServerAuthPasswordResetInvalidCodeError extends BaseError {
+    constructor();
+}

package/src/lib/auth/auth.service.error.util.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Wraps an async function that uses {@link FirebaseServerUserPasswordResetService} methods,
+ * catching password-reset-specific errors and re-throwing them as appropriate {@link HttpsError} instances
+ * suitable for returning to clients.
+ *
+ * Error mapping:
+ * - {@link FirebaseServerAuthPasswordResetInvalidCodeError} → permission-denied (403)
+ * - {@link FirebaseServerAuthPasswordResetNoResetConfigError} → bad-request (400)
+ * - {@link FirebaseServerAuthPasswordResetThrottleError} → unavailable (503)
+ * - {@link FirebaseServerAuthPasswordResetSendOnceError} → bad-request (400)
+ *
+ * @param fn - The async function to execute.
+ * @returns The result of the function.
+ */
+export declare function catchAndThrowPasswordResetServerErrors<T>(fn: () => Promise<T>): Promise<T>;
+/**
+ * Creates a permission-denied (403) server error for an invalid or expired password reset code.
+ *
+ * @returns An {@link HttpsError} with code `permission-denied`.
+ */
+export declare function authServicePasswordResetInvalidCodeError(): import("firebase-functions/https").HttpsError;
+/**
+ * Creates a bad-request (400) server error when no active password reset exists for the user.
+ *
+ * @returns An {@link HttpsError} with code `invalid-argument`.
+ */
+export declare function authServicePasswordResetNoConfigError(): import("firebase-functions/https").HttpsError;
+/**
+ * Creates an unavailable (503) server error when password reset email sending is throttled.
+ *
+ * @returns An {@link HttpsError} with code `unavailable`.
+ */
+export declare function authServicePasswordResetThrottleError(): import("firebase-functions/https").HttpsError;
+/**
+ * Creates a bad-request (400) server error when the password reset email has already been sent
+ * and the send-once constraint is active.
+ *
+ * @returns An {@link HttpsError} with code `invalid-argument`.
+ */
+export declare function authServicePasswordResetSendOnceError(): import("firebase-functions/https").HttpsError;

package/src/lib/auth/index.d.ts

@@ -1,4 +1,5 @@
 export * from './auth.service';
 export * from './auth.service.error';
+export * from './auth.service.error.util';
 export * from './auth.context';
 export * from './auth.util';

package/test/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@dereekb/firebase-server/test",
-  "version": "13.7.0",
+  "version": "13.8.0",
   "peerDependencies": {
-    "@dereekb/analytics": "13.7.0",
-    "@dereekb/date": "13.7.0",
-    "@dereekb/firebase": "13.7.0",
-    "@dereekb/firebase-server": "13.7.0",
-    "@dereekb/firebase-server/oidc": "13.7.0",
-    "@dereekb/model": "13.7.0",
-    "@dereekb/nestjs": "13.7.0",
-    "@dereekb/rxjs": "13.7.0",
-    "@dereekb/util": "13.7.0",
+    "@dereekb/analytics": "13.8.0",
+    "@dereekb/date": "13.8.0",
+    "@dereekb/firebase": "13.8.0",
+    "@dereekb/firebase-server": "13.8.0",
+    "@dereekb/firebase-server/oidc": "13.8.0",
+    "@dereekb/model": "13.8.0",
+    "@dereekb/nestjs": "13.8.0",
+    "@dereekb/rxjs": "13.8.0",
+    "@dereekb/util": "13.8.0",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
     "@nestjs/common": "^11.1.17",
     "@nestjs/testing": "^11.1.14",
-    "firebase-admin": "^13.0.0",
+    "firebase-admin": "^13.8.0",
     "firebase-functions": "^7.0.0",
     "firebase-functions-test": "3.4.1",
     "jsonwebtoken": "^9.0.0",
@@ -23,7 +23,7 @@
     "supertest": "^7.2.2"
   },
   "devDependencies": {
-    "@dereekb/nestjs": "13.7.0"
+    "@dereekb/nestjs": "13.8.0"
   },
   "exports": {
     "./package.json": "./package.json",

package/zoho/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/zoho",
-  "version": "13.7.0",
+  "version": "13.8.0",
   "peerDependencies": {
-    "@dereekb/analytics": "13.7.0",
-    "@dereekb/date": "13.7.0",
-    "@dereekb/model": "13.7.0",
-    "@dereekb/nestjs": "13.7.0",
-    "@dereekb/rxjs": "13.7.0",
-    "@dereekb/firebase": "13.7.0",
-    "@dereekb/util": "13.7.0",
-    "@dereekb/zoho": "13.7.0"
+    "@dereekb/analytics": "13.8.0",
+    "@dereekb/date": "13.8.0",
+    "@dereekb/model": "13.8.0",
+    "@dereekb/nestjs": "13.8.0",
+    "@dereekb/rxjs": "13.8.0",
+    "@dereekb/firebase": "13.8.0",
+    "@dereekb/util": "13.8.0",
+    "@dereekb/zoho": "13.8.0"
   },
   "exports": {
     "./package.json": "./package.json",