@nauth-toolkit/core 0.1.91 → 0.1.92

package/dist/bootstrap.d.ts

@@ -81,6 +81,10 @@ export interface NAuthInstance<TMiddleware = unknown, THelper = unknown> extends
         optionalAuth: () => THelper;
         /** Override token delivery mode */
         tokenDelivery: (mode: 'json' | 'cookies') => THelper;
+        /** Skip reCAPTCHA validation for this route */
+        skipRecaptcha: () => THelper;
+        /** Require reCAPTCHA validation for this route */
+        requireRecaptcha: () => THelper;
         /** Get current authenticated user */
         getCurrentUser: () => IUser | undefined;
         /** Get current session ID */

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAA+B,MAAM,uBAAuB,CAAC;AASlF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAgB,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE1E,OAAO,EAAkB,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjF,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAOxD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IAEpB,yBAAyB;IACzB,UAAU,EAAE,UAAU,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,WAAW,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,CACrE,SAAQ,IAAI,CAAC,aAAa,EAAE,kBAAkB,GAAG,4BAA4B,CAAC,EAAE,oBAAoB;IACpG,0CAA0C;IAC1C,UAAU,EAAE;QACV,6CAA6C;QAC7C,UAAU,EAAE,WAAW,CAAC;QACxB,yBAAyB;QACzB,IAAI,EAAE,WAAW,CAAC;QAClB,sBAAsB;QACtB,IAAI,EAAE,WAAW,CAAC;QAClB,4CAA4C;QAC5C,aAAa,EAAE,WAAW,CAAC;KAC5B,CAAC;IAEF,oBAAoB;IACpB,OAAO,EAAE;QACP,2CAA2C;QAC3C,MAAM,EAAE,MAAM,OAAO,CAAC;QACtB,yDAAyD;QACzD,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,KAAK,OAAO,CAAC;QACvD,qCAAqC;QACrC,YAAY,EAAE,MAAM,OAAO,CAAC;QAC5B,mCAAmC;QACnC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;QACrD,qCAAqC;QACrC,cAAc,EAAE,MAAM,KAAK,GAAG,SAAS,CAAC;QACxC,6BAA6B;QAC7B,iBAAiB,EAAE,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACrD,sBAAsB;QACtB,aAAa,EAAE,MAAM,UAAU,GAAG,SAAS,CAAC;KAC7C,CAAC;IAEF,6BAA6B;IAC7B,OAAO,EAAE,YAAY,CAAC;IAEtB,oBAAoB;IACpB,MAAM,EAAE,WAAW,CAAC;IAEpB,sBAAsB;IACtB,MAAM,EAAE,WAAW,CAAC;IAEpB,gCAAgC;IAChC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAMD;;;;GAIG;AACH,qBAAa,KAAK;IAChB;;;;;;;;;;;;;;OAcG;WACU,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CA6NnE"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAA+B,MAAM,uBAAuB,CAAC;AASlF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAgB,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE1E,OAAO,EAAkB,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjF,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAOxD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IAEpB,yBAAyB;IACzB,UAAU,EAAE,UAAU,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,WAAW,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,CACrE,SAAQ,IAAI,CAAC,aAAa,EAAE,kBAAkB,GAAG,4BAA4B,CAAC,EAAE,oBAAoB;IACpG,0CAA0C;IAC1C,UAAU,EAAE;QACV,6CAA6C;QAC7C,UAAU,EAAE,WAAW,CAAC;QACxB,yBAAyB;QACzB,IAAI,EAAE,WAAW,CAAC;QAClB,sBAAsB;QACtB,IAAI,EAAE,WAAW,CAAC;QAClB,4CAA4C;QAC5C,aAAa,EAAE,WAAW,CAAC;KAC5B,CAAC;IAEF,oBAAoB;IACpB,OAAO,EAAE;QACP,2CAA2C;QAC3C,MAAM,EAAE,MAAM,OAAO,CAAC;QACtB,yDAAyD;QACzD,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,KAAK,OAAO,CAAC;QACvD,qCAAqC;QACrC,YAAY,EAAE,MAAM,OAAO,CAAC;QAC5B,mCAAmC;QACnC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;QACrD,+CAA+C;QAC/C,aAAa,EAAE,MAAM,OAAO,CAAC;QAC7B,kDAAkD;QAClD,gBAAgB,EAAE,MAAM,OAAO,CAAC;QAChC,qCAAqC;QACrC,cAAc,EAAE,MAAM,KAAK,GAAG,SAAS,CAAC;QACxC,6BAA6B;QAC7B,iBAAiB,EAAE,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACrD,sBAAsB;QACtB,aAAa,EAAE,MAAM,UAAU,GAAG,SAAS,CAAC;KAC7C,CAAC;IAEF,6BAA6B;IAC7B,OAAO,EAAE,YAAY,CAAC;IAEtB,oBAAoB;IACpB,MAAM,EAAE,WAAW,CAAC;IAEpB,sBAAsB;IACtB,MAAM,EAAE,WAAW,CAAC;IAEpB,gCAAgC;IAChC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAMD;;;;GAIG;AACH,qBAAa,KAAK;IAChB;;;;;;;;;;;;;;OAcG;WACU,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CAmRnE"}

package/dist/bootstrap.js

@@ -192,6 +192,56 @@ class NAuth {
                 req.attributes.nauthTokenDelivery = mode;
                 return next();
             }),
+            /**
+             * Skip reCAPTCHA validation for this route
+             *
+             * Use when a specific route should bypass reCAPTCHA even if globally enabled.
+             * Useful for admin routes, mobile-only endpoints, or internal API calls.
+             *
+             * @example
+             * ```typescript
+             * // Express
+             * app.post('/api/auth/login/admin', nauth.helpers.skipRecaptcha(), (req, res) => {
+             *   // ... admin login logic
+             * });
+             *
+             * // Fastify
+             * fastify.post('/api/auth/login/admin', {
+             *   preHandler: [nauth.helpers.skipRecaptcha()]
+             * }, async (req, reply) => {
+             *   // ... admin login logic
+             * });
+             * ```
+             */
+            skipRecaptcha: () => adapter.registerMiddleware('skipRecaptcha', (req, _res, next) => {
+                req.attributes.nauthSkipRecaptcha = true;
+                return next();
+            }),
+            /**
+             * Require reCAPTCHA validation for this route
+             *
+             * Use when a specific route must enforce reCAPTCHA even if not globally enabled.
+             * Useful for high-risk operations like password reset or account deletion.
+             *
+             * @example
+             * ```typescript
+             * // Express
+             * app.post('/api/auth/password/reset', nauth.helpers.requireRecaptcha(), (req, res) => {
+             *   // ... password reset logic
+             * });
+             *
+             * // Fastify
+             * fastify.post('/api/auth/password/reset', {
+             *   preHandler: [nauth.helpers.requireRecaptcha()]
+             * }, async (req, reply) => {
+             *   // ... password reset logic
+             * });
+             * ```
+             */
+            requireRecaptcha: () => adapter.registerMiddleware('requireRecaptcha', (req, _res, next) => {
+                req.attributes.nauthRequireRecaptcha = true;
+                return next();
+            }),
             // Context helpers (read from ContextStorage)
             getCurrentUser: () => context_storage_1.ContextStorage.get('CURRENT_USER'),
             getCurrentSession: () => context_storage_1.ContextStorage.get('CURRENT_SESSION'),

package/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAIH,uDAAmD;AACnD,kEAA8D;AAC9D,+DAAyD;AAEzD,gEAA4D;AAC5D,6DAAyD;AAEzD,WAAW;AACX,wEAAmE;AACnE,0DAAsD;AACtD,8EAAyE;AACzE,0DAAsD;AACtD,0DAAsD;AAEtD,gBAAgB;AAChB,qEAAiE;AACjE,6DAAyD;AACzD,+DAA0E;AAC1E,6DAAkE;AAClE,2DAAiF;AACjF,6EAAiF;AACjF,yCAAiF;AAGjF,gGAAkF;AAgFlF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAa,KAAK;IAChB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAqB;QACvC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,gCAAc,EAAE,CAAC;QAExD,MAAM,MAAM,GAAG,IAAI,0BAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,2BAA2B,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC;QAEzD,2EAA2E;QAC3E,2EAA2E;QAC3E,2EAA2E;QAC3E,MAAM,IAAA,kDAA2B,EAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAE9D,2EAA2E;QAC3E,uCAAuC;QACvC,2EAA2E;QAC3E,MAAM,KAAK,GAAG,IAAA,kCAAe,EAAC,UAAU,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAW,EAAC,MAAM,EAAE,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QAE1G,2EAA2E;QAC3E,yBAAyB;QACzB,2EAA2E;QAC3E,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC3C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACvC,MAAM,QAAQ,GAAkB,IAAA,4BAAY,EAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;QAEzG,2EAA2E;QAC3E,wCAAwC;QACxC,2EAA2E;QAC3E,MAAM,cAAc,GAAG,IAAI,iCAAsB,CAC/C,QAAQ,CAAC,oBAAoB,EAC7B,QAAQ,CAAC,0BAA0B,EACnC,QAAQ,CAAC,iBAAiB,EAC1B,MAAM,CACP,CAAC;QACF,MAAM,YAAY,GAAG,IAAI,sCAA2B,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAE7E,IAAI,QAAQ,CAAC,0BAA0B,EAAE,CAAC;YACvC,QAAQ,CAAC,0BAAiE,CAAC,YAAY,GAAG,YAAY,CAAC;YACvG,QAAQ,CAAC,0BAAiE,CAAC,cAAc,GAAG,cAAc,CAAC;QAC9G,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,gCAAc,CAAC,gCAAa,CAAC,cAAc,EAAE,6CAA6C,CAAC,CAAC;QACxG,CAAC;QAED,2EAA2E;QAC3E,qCAAqC;QACrC,2EAA2E;QAC3E,MAAM,oBAAoB,GAAG,IAAI,sDAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEvE,IAAI,MAAM,CAAC,GAAG,EAAE,OAAO,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC/C,MAAM,IAAA,mCAAoB,EACxB,MAAM,EACN,QAAQ,CAAC,UAAU,EACnB,KAAK,CAAC,mBAAoB,EAC1B,KAAK,CAAC,cAAc,EACpB,MAAM,EACN,QAAQ,CAAC,eAAe,EACxB,QAAQ,CAAC,wBAAwB,EACjC,QAAQ,CAAC,wBAAwB,EACjC,QAAQ,CAAC,gBAAgB,EACzB,QAAQ,CAAC,YAAY,EACrB,QAAQ,CAAC,iBAAiB,CAC3B,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAyB,MAAM,IAAA,4BAAc,EAChE,MAAM,EACN,QAAQ,CAAC,sBAAsB,EAC/B,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,iBAAiB,EAC1B,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,cAAc,EACvB,QAAQ,CAAC,0BAA0B,EACnC,QAAQ,CAAC,iBAAiB,EAC1B,MAAM,EACN,oBAAoB,EACpB,KAAK,CAAC,cAAc,EACpB,QAAQ,CAAC,wBAAwB,EACjC,QAAQ,CAAC,YAAY,EACrB,QAAQ,CAAC,oBAAoB,EAC7B,KAAK,CAAC,8BAA8B,EACpC,QAAQ,CAAC,YAAY,CACtB,CAAC;QAEF,2EAA2E;QAC3E,qBAAqB;QACrB,2EAA2E;QAC3E,MAAM,iBAAiB,GAAG,IAAI,uCAAiB,CAAC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QAEjH,MAAM,WAAW,GAAG,IAAI,0BAAW,CACjC,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,cAAc,EACvB,QAAQ,CAAC,WAAW,EACpB,MAAM,EACN,MAAM,CACP,CAAC;QAEF,MAAM,oBAAoB,GAAG,IAAI,6CAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEtE,kDAAkD;QAClD,MAAM,WAAW,GACf,MAAM,CAAC,aAAa,EAAE,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,KAAK,QAAQ;YACrF,CAAC,CAAC,IAAI,0BAAW,CAAC,MAAM,CAAC;YACzB,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,0BAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEtF,2EAA2E;QAC3E,sCAAsC;QACtC,2EAA2E;QAC3E,MAAM,UAAU,GAAG;YACjB,iDAAiD;YACjD,UAAU,EAAE,OAAO,CAAC,kBAAkB,CAAC,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE;gBACrG,kBAAkB,EAAE,IAAI;aACzB,CAAC;YAEF,eAAe;YACf,IAAI,EAAE,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAE9E,mCAAmC;YACnC,IAAI,EAAE,WAAW;gBACf,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC1E,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAkB,EAAE,IAAmB,EAAE,IAAgB,EAAE,EAAE;oBACrG,MAAM,IAAI,EAAE,CAAC;gBACf,CAAC,CAAC;YAEN,wCAAwC;YACxC,aAAa,EAAE,OAAO,CAAC,2BAA2B,CAChD,oBAAoB,CAAC,cAAc,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAC/D;SACF,CAAC;QAEF,2EAA2E;QAC3E,oBAAoB;QACpB,2EAA2E;QAC3E,MAAM,OAAO,GAAG;YACd;;eAEG;YACH,MAAM,EAAE,GAAG,EAAE,CACX,OAAO,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,GAAiB,EAAE,IAAmB,EAAE,IAAgB,EAAE,EAAE;gBAChG,GAAG,CAAC,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC;gBAClC,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC,CAAC;YAEJ;;;;eAIG;YACH,WAAW,EAAE,CAAC,OAA4B,EAAE,EAAE,CAC5C,OAAO,CAAC,kBAAkB,CAAC,aAAa,EAAE,CAAC,GAAiB,EAAE,GAAkB,EAAE,IAAgB,EAAE,EAAE;gBACpG,gDAAgD;gBAChD,IAAI,OAAO,EAAE,IAAI,KAAK,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;oBAC7D,MAAM,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC;gBACtC,CAAC;gBAED,yBAAyB;gBACzB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;oBACzB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;wBACnB,UAAU,EAAE,GAAG;wBACf,KAAK,EAAE,cAAc;wBACrB,OAAO,EAAE,yBAAyB;wBAClC,IAAI,EAAE,eAAe;qBACtB,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC,CAAC;YAEJ;;;;;eAKG;YACH,YAAY,EAAE,GAAG,EAAE,CACjB,OAAO,CAAC,kBAAkB,CAAC,cAAc,EAAE,CAAC,IAAkB,EAAE,IAAmB,EAAE,IAAgB,EAAE,EAAE;gBACvG,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC,CAAC;YAEJ;;eAEG;YACH,aAAa,EAAE,CAAC,IAAwB,EAAE,EAAE,CAC1C,OAAO,CAAC,kBAAkB,CACxB,qBAAqB,EACrB,CAAC,GAAiB,EAAE,IAAmB,EAAE,IAAgB,EAAE,EAAE;gBAC3D,GAAG,CAAC,UAAU,CAAC,kBAAkB,GAAG,IAAI,CAAC;gBACzC,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC,CACF;YAEH;;;;;;;;;;;;;;;;;;;;eAoBG;YACH,aAAa,EAAE,GAAG,EAAE,CAClB,OAAO,CAAC,kBAAkB,CAAC,eAAe,EAAE,CAAC,GAAiB,EAAE,IAAmB,EAAE,IAAgB,EAAE,EAAE;gBACvG,GAAG,CAAC,UAAU,CAAC,kBAAkB,GAAG,IAAI,CAAC;gBACzC,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC,CAAC;YAEJ;;;;;;;;;;;;;;;;;;;;eAoBG;YACH,gBAAgB,EAAE,GAAG,EAAE,CACrB,OAAO,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,CAAC,GAAiB,EAAE,IAAmB,EAAE,IAAgB,EAAE,EAAE;gBAC1G,GAAG,CAAC,UAAU,CAAC,qBAAqB,GAAG,IAAI,CAAC;gBAC5C,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC,CAAC;YAEJ,6CAA6C;YAC7C,cAAc,EAAE,GAAG,EAAE,CAAC,gCAAc,CAAC,GAAG,CAAQ,cAAc,CAAC;YAC/D,iBAAiB,EAAE,GAAG,EAAE,CAAC,gCAAc,CAAC,GAAG,CAAkB,iBAAiB,CAAC;YAC/E,aAAa,EAAE,GAAG,EAAE,CAAC,gCAAc,CAAC,GAAG,CAAa,aAAa,CAAC;SACnE,CAAC;QAEF,2EAA2E;QAC3E,+BAA+B;QAC/B,2EAA2E;QAE3E,4CAA4C;QAC5C,MAAM,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,GAAG,cAAc,EAAE,GAAG,QAAQ,CAAC;QAErF,MAAM,CAAC,GAAG,CAAC,uCAAuC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAElE,OAAO;YACL,GAAG,cAAc;YACjB,GAAG,eAAe;YAClB,UAAU;YACV,OAAO;YACP,OAAO;YACP,MAAM;YACN,MAAM;YACN,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;YAC7C,WAAW;SACZ,CAAC;IACJ,CAAC;CACF;AAnSD,sBAmSC"}

package/dist/dto/login.dto.d.ts

@@ -51,5 +51,38 @@ export declare class LoginDTO {
      * - Trimmed and lowercased
      */
     deviceType?: 'mobile' | 'desktop' | 'tablet';
+    /**
+     * Optional reCAPTCHA token
+     *
+     * Required when server has reCAPTCHA enabled and enforces validation
+     * for the current token delivery mode (typically 'cookies' for web).
+     *
+     * Validation:
+     * - Must be a string
+     * - Token is single-use and expires after 2 minutes
+     * - Token must be generated for correct action (e.g., 'login')
+     *
+     * Security:
+     * - Token validation happens server-side only
+     * - Invalid/expired tokens result in RECAPTCHA_VALIDATION_FAILED error
+     * - Low scores (v3) result in RECAPTCHA_SCORE_TOO_LOW error
+     *
+     * @example Web app (v3 automatic)
+     * ```typescript
+     * // Angular: Token auto-generated by AuthService
+     * await this.authService.login(email, password);
+     *
+     * // Vanilla JS: Generate token manually
+     * const token = await grecaptcha.execute(siteKey, { action: 'login' });
+     * await client.login({ identifier, password, recaptchaToken: token });
+     * ```
+     *
+     * @example Web app (v2 checkbox)
+     * ```typescript
+     * const token = grecaptcha.getResponse(widgetId);
+     * await client.login({ identifier, password, recaptchaToken: token });
+     * ```
+     */
+    recaptchaToken?: string;
 }
 //# sourceMappingURL=login.dto.d.ts.map

package/dist/dto/login.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.dto.d.ts","sourceRoot":"","sources":["../../src/dto/login.dto.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB;;;;;;;;;;OAUG;IAeH,UAAU,EAAG,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IAIH,QAAQ,EAAG,MAAM,CAAC;IAElB;;;;;;;;OAQG;IAUH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;OASG;IAWH,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC9C"}
+{"version":3,"file":"login.dto.d.ts","sourceRoot":"","sources":["../../src/dto/login.dto.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB;;;;;;;;;;OAUG;IAeH,UAAU,EAAG,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IAIH,QAAQ,EAAG,MAAM,CAAC;IAElB;;;;;;;;OAQG;IAUH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;OASG;IAWH,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IAGH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/dto/login.dto.js

@@ -79,6 +79,39 @@ class LoginDTO {
      * - Trimmed and lowercased
      */
     deviceType;
+    /**
+     * Optional reCAPTCHA token
+     *
+     * Required when server has reCAPTCHA enabled and enforces validation
+     * for the current token delivery mode (typically 'cookies' for web).
+     *
+     * Validation:
+     * - Must be a string
+     * - Token is single-use and expires after 2 minutes
+     * - Token must be generated for correct action (e.g., 'login')
+     *
+     * Security:
+     * - Token validation happens server-side only
+     * - Invalid/expired tokens result in RECAPTCHA_VALIDATION_FAILED error
+     * - Low scores (v3) result in RECAPTCHA_SCORE_TOO_LOW error
+     *
+     * @example Web app (v3 automatic)
+     * ```typescript
+     * // Angular: Token auto-generated by AuthService
+     * await this.authService.login(email, password);
+     *
+     * // Vanilla JS: Generate token manually
+     * const token = await grecaptcha.execute(siteKey, { action: 'login' });
+     * await client.login({ identifier, password, recaptchaToken: token });
+     * ```
+     *
+     * @example Web app (v2 checkbox)
+     * ```typescript
+     * const token = grecaptcha.getResponse(widgetId);
+     * await client.login({ identifier, password, recaptchaToken: token });
+     * ```
+     */
+    recaptchaToken;
 }
 exports.LoginDTO = LoginDTO;
 __decorate([
@@ -129,4 +162,9 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], LoginDTO.prototype, "deviceType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)({ message: 'ReCAPTCHA token must be a string' }),
+    __metadata("design:type", String)
+], LoginDTO.prototype, "recaptchaToken", void 0);
 //# sourceMappingURL=login.dto.js.map

package/dist/dto/login.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.dto.js","sourceRoot":"","sources":["../../src/dto/login.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAmF;AACnF,yDAA8C;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAa,QAAQ;IACnB;;;;;;;;;;OAUG;IAeH,UAAU,CAAU,CAAC,4BAA4B;IAEjD;;;;;;;;OAQG;IAIH,QAAQ,CAAU;IAElB;;;;;;;;OAQG;IAUH,UAAU,CAAU;IAEpB;;;;;;;;;OASG;IAWH,UAAU,CAAmC;CAC9C;AAnFD,4BAmFC;AAzDC;IAdC,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACpD,IAAA,2BAAS,EAAC,CAAC,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACnD,IAAA,2BAAS,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;IACxE,IAAA,6BAAS,EAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,iDAAiD;YACjD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;YAC/B,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;;4CACkB;AAcpB;IAHC,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;IAClD,IAAA,2BAAS,EAAC,CAAC,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;IACjD,IAAA,2BAAS,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;;0CACrD;AAoBlB;IATC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACpD,IAAA,2BAAS,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;IACxE,IAAA,6BAAS,EAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;;4CACkB;AAsBpB;IAVC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACpD,IAAA,sBAAI,EAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;IAC7F,IAAA,2BAAS,EAAC,EAAE,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;IACtE,IAAA,6BAAS,EAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;;4CAC2C"}
+{"version":3,"file":"login.dto.js","sourceRoot":"","sources":["../../src/dto/login.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAmF;AACnF,yDAA8C;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAa,QAAQ;IACnB;;;;;;;;;;OAUG;IAeH,UAAU,CAAU,CAAC,4BAA4B;IAEjD;;;;;;;;OAQG;IAIH,QAAQ,CAAU;IAElB;;;;;;;;OAQG;IAUH,UAAU,CAAU;IAEpB;;;;;;;;;OASG;IAWH,UAAU,CAAmC;IAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IAGH,cAAc,CAAU;CACzB;AAvHD,4BAuHC;AA7FC;IAdC,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACpD,IAAA,2BAAS,EAAC,CAAC,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACnD,IAAA,2BAAS,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;IACxE,IAAA,6BAAS,EAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,iDAAiD;YACjD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;YAC/B,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;;4CACkB;AAcpB;IAHC,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;IAClD,IAAA,2BAAS,EAAC,CAAC,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;IACjD,IAAA,2BAAS,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;;0CACrD;AAoBlB;IATC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACpD,IAAA,2BAAS,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;IACxE,IAAA,6BAAS,EAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;;4CACkB;AAsBpB;IAVC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACpD,IAAA,sBAAI,EAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;IAC7F,IAAA,2BAAS,EAAC,EAAE,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;IACtE,IAAA,6BAAS,EAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;;4CAC2C;AAoC7C;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,EAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;;gDAClC"}

package/dist/dto/signup.dto.d.ts

@@ -96,5 +96,38 @@ export declare class SignupDTO {
      * - Max depth/size limits should be enforced
      */
     metadata?: Record<string, unknown>;
+    /**
+     * Optional reCAPTCHA token
+     *
+     * Required when server has reCAPTCHA enabled and enforces validation
+     * for the current token delivery mode (typically 'cookies' for web).
+     *
+     * Validation:
+     * - Must be a string
+     * - Token is single-use and expires after 2 minutes
+     * - Token must be generated for correct action (e.g., 'signup')
+     *
+     * Security:
+     * - Token validation happens server-side only
+     * - Invalid/expired tokens result in RECAPTCHA_VALIDATION_FAILED error
+     * - Low scores (v3) result in RECAPTCHA_SCORE_TOO_LOW error
+     *
+     * @example Web app (v3 automatic)
+     * ```typescript
+     * // Angular: Token auto-generated by AuthService
+     * await this.authService.signup({ email, password });
+     *
+     * // Vanilla JS: Generate token manually
+     * const token = await grecaptcha.execute(siteKey, { action: 'signup' });
+     * await client.signup({ email, password, recaptchaToken: token });
+     * ```
+     *
+     * @example Web app (v2 checkbox)
+     * ```typescript
+     * const token = grecaptcha.getResponse(widgetId);
+     * await client.signup({ email, password, recaptchaToken: token });
+     * ```
+     */
+    recaptchaToken?: string;
 }
 //# sourceMappingURL=signup.dto.d.ts.map

package/dist/dto/signup.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signup.dto.d.ts","sourceRoot":"","sources":["../../src/dto/signup.dto.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB;;;;;;;;;OASG;IASH,KAAK,EAAG,MAAM,CAAC;IAEf;;;;;;;;;OASG;IAIH,QAAQ,EAAG,MAAM,CAAC;IAElB;;;;;;;;;;;OAWG;IAcH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;OAUG;IAWH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;OAUG;IAWH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;;;;;;;;OAmBG;IAcH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IAEH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}
+{"version":3,"file":"signup.dto.d.ts","sourceRoot":"","sources":["../../src/dto/signup.dto.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB;;;;;;;;;OASG;IASH,KAAK,EAAG,MAAM,CAAC;IAEf;;;;;;;;;OASG;IAIH,QAAQ,EAAG,MAAM,CAAC;IAElB;;;;;;;;;;;OAWG;IAcH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;OAUG;IAWH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;OAUG;IAWH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;;;;;;;;OAmBG;IAcH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IAEH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IAGH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/dto/signup.dto.js

@@ -110,6 +110,39 @@ class SignupDTO {
      * - Max depth/size limits should be enforced
      */
     metadata;
+    /**
+     * Optional reCAPTCHA token
+     *
+     * Required when server has reCAPTCHA enabled and enforces validation
+     * for the current token delivery mode (typically 'cookies' for web).
+     *
+     * Validation:
+     * - Must be a string
+     * - Token is single-use and expires after 2 minutes
+     * - Token must be generated for correct action (e.g., 'signup')
+     *
+     * Security:
+     * - Token validation happens server-side only
+     * - Invalid/expired tokens result in RECAPTCHA_VALIDATION_FAILED error
+     * - Low scores (v3) result in RECAPTCHA_SCORE_TOO_LOW error
+     *
+     * @example Web app (v3 automatic)
+     * ```typescript
+     * // Angular: Token auto-generated by AuthService
+     * await this.authService.signup({ email, password });
+     *
+     * // Vanilla JS: Generate token manually
+     * const token = await grecaptcha.execute(siteKey, { action: 'signup' });
+     * await client.signup({ email, password, recaptchaToken: token });
+     * ```
+     *
+     * @example Web app (v2 checkbox)
+     * ```typescript
+     * const token = grecaptcha.getResponse(widgetId);
+     * await client.signup({ email, password, recaptchaToken: token });
+     * ```
+     */
+    recaptchaToken;
 }
 exports.SignupDTO = SignupDTO;
 __decorate([
@@ -191,4 +224,9 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", Object)
 ], SignupDTO.prototype, "metadata", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)({ message: 'ReCAPTCHA token must be a string' }),
+    __metadata("design:type", String)
+], SignupDTO.prototype, "recaptchaToken", void 0);
 //# sourceMappingURL=signup.dto.js.map

package/dist/dto/signup.dto.js.map

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

package/dist/enums/error-codes.enum.d.ts

@@ -329,6 +329,61 @@ export declare enum AuthErrorCode {
      * Used when confirming a forgot-password code exceeds max attempts.
      */
     PASSWORD_RESET_MAX_ATTEMPTS = "PASSWORD_RESET_MAX_ATTEMPTS",
+    /**
+     * reCAPTCHA token is required but not provided
+     *
+     * The server requires reCAPTCHA validation for this endpoint,
+     * but no token was included in the request.
+     *
+     * Client should:
+     * 1. Check if reCAPTCHA is enabled in SDK configuration
+     * 2. Ensure token generation is working (v3 auto, v2 checkbox)
+     * 3. Verify token is being sent in request body
+     */
+    RECAPTCHA_REQUIRED = "RECAPTCHA_REQUIRED",
+    /**
+     * reCAPTCHA provider is not configured on server
+     *
+     * Server has reCAPTCHA enabled but no provider instance configured.
+     * This is a configuration error, not a client error.
+     *
+     * Admin should check `recaptcha.provider` in server config.
+     */
+    RECAPTCHA_PROVIDER_MISSING = "RECAPTCHA_PROVIDER_MISSING",
+    /**
+     * reCAPTCHA token validation failed
+     *
+     * Google's API rejected the token. Possible reasons:
+     * - Token is invalid or malformed
+     * - Token has expired (tokens are single-use, 2-minute lifetime)
+     * - Token was already used (replay attack)
+     * - Wrong site key (dev vs prod mismatch)
+     * - Network connectivity issues
+     *
+     * Client should generate a new token and retry.
+     *
+     * Details may include:
+     * - errorCodes: Array of error codes from Google API
+     */
+    RECAPTCHA_VALIDATION_FAILED = "RECAPTCHA_VALIDATION_FAILED",
+    /**
+     * reCAPTCHA v3 score too low (likely bot)
+     *
+     * Token is valid but the risk score is below the minimum threshold.
+     * Indicates likely bot or automated activity.
+     *
+     * v3 scores range from 0.0 (bot) to 1.0 (human).
+     * Default threshold: 0.5
+     *
+     * Details may include:
+     * - score: The actual score received (0.0-1.0)
+     * - minimumScore: The required threshold
+     *
+     * **User actions:**
+     * - Legitimate users may need to contact support
+     * - Bots/scripts will be blocked
+     */
+    RECAPTCHA_SCORE_TOO_LOW = "RECAPTCHA_SCORE_TOO_LOW",
     /**
      * Requested resource not found
      */

package/dist/enums/error-codes.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.enum.d.ts","sourceRoot":"","sources":["../../src/enums/error-codes.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,oBAAY,aAAa;IAKvB;;;;OAIG;IACH,mBAAmB,6BAA6B;IAEhD;;;;OAIG;IACH,cAAc,wBAAwB;IAEtC;;;;OAIG;IACH,gBAAgB,0BAA0B;IAE1C;;;;OAIG;IACH,aAAa,uBAAuB;IAEpC;;;;OAIG;IACH,aAAa,uBAAuB;IAEpC;;;;;OAKG;IACH,kBAAkB,4BAA4B;IAE9C;;;;OAIG;IACH,mBAAmB,6BAA6B;IAEhD;;;;OAIG;IACH,kBAAkB,4BAA4B;IAE9C;;;;OAIG;IACH,kBAAkB,4BAA4B;IAE9C;;;;OAIG;IACH,oBAAoB,8BAA8B;IAElD;;OAEG;IACH,iBAAiB,2BAA2B;IAE5C;;OAEG;IACH,eAAe,yBAAyB;IAMxC;;;;OAIG;IACH,eAAe,oBAAoB;IAEnC;;;;OAIG;IACH,YAAY,wBAAwB;IAEpC;;;;OAIG;IACH,eAAe,2BAA2B;IAE1C;;;;OAIG;IACH,YAAY,wBAAwB;IAEpC;;;;OAIG;IACH,aAAa,yBAAyB;IAEtC;;;;OAIG;IACH,cAAc,0BAA0B;IAExC;;OAEG;IACH,kBAAkB,uBAAuB;IAEzC;;;;;OAKG;IACH,gBAAgB,4BAA4B;IAM5C;;;;OAIG;IACH,yBAAyB,wBAAwB;IAEjD;;;;OAIG;IACH,yBAAyB,wBAAwB;IAEjD;;;;OAIG;IACH,8BAA8B,6BAA6B;IAE3D;;;;OAIG;IACH,gBAAgB,4BAA4B;IAM5C;;;;;;OAMG;IACH,kBAAkB,uBAAuB;IAMzC;;;;OAIG;IACH,cAAc,mBAAmB;IAEjC;;;;OAIG;IACH,gBAAgB,qBAAqB;IAErC;;;;OAIG;IACH,gBAAgB,qBAAqB;IAErC;;;;OAIG;IACH,iBAAiB,sBAAsB;IAEvC;;;;;OAKG;IACH,yBAAyB,8BAA8B;IAMvD;;;;OAIG;IACH,oBAAoB,yBAAyB;IAE7C;;;;OAIG;IACH,qBAAqB,0BAA0B;IAE/C;;;;OAIG;IACH,qBAAqB,0BAA0B;IAE/C;;;;OAIG;IACH,qBAAqB,0BAA0B;IAE/C;;;;OAIG;IACH,wBAAwB,6BAA6B;IAErD;;;;;OAKG;IACH,qBAAqB,0BAA0B;IAM/C;;;;OAIG;IACH,iBAAiB,sBAAsB;IAEvC;;;;OAIG;IACH,iBAAiB,sBAAsB;IAEvC;;;;OAIG;IACH,uBAAuB,4BAA4B;IAEnD;;;;OAIG;IACH,sBAAsB,2BAA2B;IAEjD;;OAEG;IACH,2BAA2B,gCAAgC;IAM3D;;;;OAIG;IACH,iBAAiB,sBAAsB;IAEvC;;;;OAIG;IACH,oBAAoB,6BAA6B;IAEjD;;OAEG;IACH,oBAAoB,6BAA6B;IAEjD;;;;OAIG;IACH,uBAAuB,gCAAgC;IAMvD;;;;OAIG;IACH,kBAAkB,uBAAuB;IAEzC;;;;OAIG;IACH,eAAe,oBAAoB;IAEnC;;;;OAIG;IACH,2BAA2B,gCAAgC;IAM3D;;;;OAIG;IACH,2BAA2B,gCAAgC;IAE3D;;;;OAIG;IACH,2BAA2B,gCAAgC;IAE3D;;;;OAIG;IACH,2BAA2B,gCAAgC;IAM3D;;OAEG;IACH,SAAS,uBAAuB;IAEhC;;;;OAIG;IACH,cAAc,mBAAmB;IAEjC;;;;OAIG;IACH,cAAc,mBAAmB;IAEjC;;;;OAIG;IACH,SAAS,cAAc;IAEvB;;;;OAIG;IACH,mBAAmB,wBAAwB;IAM3C;;;;;;;;;;OAUG;IACH,wBAAwB,6BAA6B;CACtD"}
+{"version":3,"file":"error-codes.enum.d.ts","sourceRoot":"","sources":["../../src/enums/error-codes.enum.ts"],"names":[],"mappings":"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"}

package/dist/enums/error-codes.enum.js

@@ -364,6 +364,64 @@ var AuthErrorCode;
      */
     AuthErrorCode["PASSWORD_RESET_MAX_ATTEMPTS"] = "PASSWORD_RESET_MAX_ATTEMPTS";
     // ============================================================================
+    // reCAPTCHA Errors (RECAPTCHA_*)
+    // ============================================================================
+    /**
+     * reCAPTCHA token is required but not provided
+     *
+     * The server requires reCAPTCHA validation for this endpoint,
+     * but no token was included in the request.
+     *
+     * Client should:
+     * 1. Check if reCAPTCHA is enabled in SDK configuration
+     * 2. Ensure token generation is working (v3 auto, v2 checkbox)
+     * 3. Verify token is being sent in request body
+     */
+    AuthErrorCode["RECAPTCHA_REQUIRED"] = "RECAPTCHA_REQUIRED";
+    /**
+     * reCAPTCHA provider is not configured on server
+     *
+     * Server has reCAPTCHA enabled but no provider instance configured.
+     * This is a configuration error, not a client error.
+     *
+     * Admin should check `recaptcha.provider` in server config.
+     */
+    AuthErrorCode["RECAPTCHA_PROVIDER_MISSING"] = "RECAPTCHA_PROVIDER_MISSING";
+    /**
+     * reCAPTCHA token validation failed
+     *
+     * Google's API rejected the token. Possible reasons:
+     * - Token is invalid or malformed
+     * - Token has expired (tokens are single-use, 2-minute lifetime)
+     * - Token was already used (replay attack)
+     * - Wrong site key (dev vs prod mismatch)
+     * - Network connectivity issues
+     *
+     * Client should generate a new token and retry.
+     *
+     * Details may include:
+     * - errorCodes: Array of error codes from Google API
+     */
+    AuthErrorCode["RECAPTCHA_VALIDATION_FAILED"] = "RECAPTCHA_VALIDATION_FAILED";
+    /**
+     * reCAPTCHA v3 score too low (likely bot)
+     *
+     * Token is valid but the risk score is below the minimum threshold.
+     * Indicates likely bot or automated activity.
+     *
+     * v3 scores range from 0.0 (bot) to 1.0 (human).
+     * Default threshold: 0.5
+     *
+     * Details may include:
+     * - score: The actual score received (0.0-1.0)
+     * - minimumScore: The required threshold
+     *
+     * **User actions:**
+     * - Legitimate users may need to contact support
+     * - Bots/scripts will be blocked
+     */
+    AuthErrorCode["RECAPTCHA_SCORE_TOO_LOW"] = "RECAPTCHA_SCORE_TOO_LOW";
+    // ============================================================================
     // General Errors (*)
     // ============================================================================
     /**

package/dist/enums/error-codes.enum.js.map

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