@koolbase/react-native 12.0.0 → 12.2.0

package/CHANGELOG.md

@@ -7,6 +7,48 @@ adheres to [Semantic Versioning][semver].
 [kac]: https://keepachangelog.com/en/1.1.0/
 [semver]: https://semver.org/
 
+## 12.2.0
+
+### Added
+
+- **Two-step sign-in (MFA).** Every sign-in method now throws `MfaRequiredError`
+  carrying a `challengeToken` when the person's account has an authenticator on
+  — including phone, Google and Apple, whose error parsers all map it, enforced
+  by a source test for any parser added later. `verifyMfa({ challengeToken, code
+  })` and `verifyRecoveryCode({ challengeToken, code })` finish sign-in and
+  store the session, returning `{ session, recoveryCodesRemaining }` for the
+  latter.
+- `enrollMfa()`, `confirmMfaEnrollment(code)`, `mfaStatus()`, `stepUpMfa(…)`,
+  `disableMfa()`, and `regenerateRecoveryCodes()` manage it. Six new error
+  classes in the mapping table and fidelity list.
+
+## 12.1.0
+
+### Added
+
+- **Sign in with an emailed code.** `auth.requestEmailCode({ email })` sends a
+  six-digit code; `auth.signInWithEmailCode({ email, code })` signs in and
+  stores the session exactly as `login()` does. An unknown address becomes an
+  account only while the project accepts sign-ups. Each code works once and
+  allows three attempts. The request resolves the same way whether or not the
+  address has an account. A project can switch this off; requests then throw
+  `EmailCodeDisabledError`.
+- **Fiscal.** `KoolbaseFiscal` with `submit()` and `status()`, and
+  `KoolbaseFiscalError`. A timeout on `submit` means poll `status()` with the
+  same `clientRef` — do not submit again, or the sale may be recorded twice.
+- **Reference errors are catchable.** `KoolbaseReferenceInvalidError`,
+  `KoolbaseReferenceInUseError`, `KoolbaseDanglingReferencesError` (carrying
+  the offending records) and `KoolbaseCollectionReferencedError`.
+
+### Changed
+
+- The OTP errors (`OtpInvalidError`, `OtpExpiredError`,
+  `OtpMaxAttemptsError`) now come from the shared error mapping, so every path
+  that returns them throws the class an app catches.
+- `oauthLogin()`'s deprecation now points to `signInWithGoogle()` and
+  `signInWithApple()`. It said OAuth was not yet shipped and to use email and
+  password instead, which had long stopped being true.
+
 ## 12.0.0
 
 ### Breaking

package/dist/cjs/index.d.ts

@@ -1,11 +1,12 @@
 export * from '@koolbase/core';
 export { reactNativePlatform } from './platform.js';
-import { KoolbaseAuth, KoolbaseDatabase, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseAnalytics, KoolbaseMessaging, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseAnalytics, KoolbaseMessaging, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
 export declare const Koolbase: {
     initialize(config: KoolbaseConfig): Promise<void>;
     readonly auth: KoolbaseAuth;
     readonly db: KoolbaseDatabase;
     readonly storage: KoolbaseStorage;
+    readonly fiscal: KoolbaseFiscal;
     readonly realtime: KoolbaseRealtime;
     readonly functions: KoolbaseFunctions;
     isEnabled(key: string): boolean;

package/dist/cjs/index.js

@@ -29,6 +29,7 @@ const platform_js_2 = require("./platform.js");
 let _auth = null;
 let _db = null;
 let _storage = null;
+let _fiscal = null;
 let _realtime = null;
 let _functions = null;
 let _flags = null;
@@ -66,6 +67,7 @@ exports.Koolbase = {
             // route to login, rather than looping on a dead token.
             async () => { await _auth?.clearStoredSession(); });
             _storage = new core_1.KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
+            _fiscal = new core_1.KoolbaseFiscal(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
             _realtime = new core_1.KoolbaseRealtime(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), () => _auth?.currentUser?.id ?? null);
             _functions = new core_1.KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
             // One anonymous device id for the whole SDK — bucketing (flags), targeting
@@ -105,6 +107,10 @@ exports.Koolbase = {
         ensureInitialized();
         return _storage;
     },
+    get fiscal() {
+        ensureInitialized();
+        return _fiscal;
+    },
     get realtime() {
         ensureInitialized();
         return _realtime;

package/dist/esm/index.d.ts

@@ -1,11 +1,12 @@
 export * from '@koolbase/core';
 export { reactNativePlatform } from './platform.js';
-import { KoolbaseAuth, KoolbaseDatabase, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseAnalytics, KoolbaseMessaging, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseAnalytics, KoolbaseMessaging, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
 export declare const Koolbase: {
     initialize(config: KoolbaseConfig): Promise<void>;
     readonly auth: KoolbaseAuth;
     readonly db: KoolbaseDatabase;
     readonly storage: KoolbaseStorage;
+    readonly fiscal: KoolbaseFiscal;
     readonly realtime: KoolbaseRealtime;
     readonly functions: KoolbaseFunctions;
     isEnabled(key: string): boolean;

package/dist/esm/index.js

@@ -6,11 +6,12 @@
 // React Native platform adapter and keychain-backed session storage.
 export * from '@koolbase/core';
 export { reactNativePlatform } from './platform.js';
-import { KoolbaseAuth, KoolbaseDatabase, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseFlags, KoolbaseAnalytics, KoolbaseMessaging, getOrCreateDeviceId, setPlatform, } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseFlags, KoolbaseAnalytics, KoolbaseMessaging, getOrCreateDeviceId, setPlatform, } from '@koolbase/core';
 import { reactNativePlatform } from './platform.js';
 let _auth = null;
 let _db = null;
 let _storage = null;
+let _fiscal = null;
 let _realtime = null;
 let _functions = null;
 let _flags = null;
@@ -48,6 +49,7 @@ export const Koolbase = {
             // route to login, rather than looping on a dead token.
             async () => { await _auth?.clearStoredSession(); });
             _storage = new KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
+            _fiscal = new KoolbaseFiscal(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
             _realtime = new KoolbaseRealtime(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), () => _auth?.currentUser?.id ?? null);
             _functions = new KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
             // One anonymous device id for the whole SDK — bucketing (flags), targeting
@@ -87,6 +89,10 @@ export const Koolbase = {
         ensureInitialized();
         return _storage;
     },
+    get fiscal() {
+        ensureInitialized();
+        return _fiscal;
+    },
     get realtime() {
         ensureInitialized();
         return _realtime;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/react-native",
-  "version": "12.0.0",
+  "version": "12.2.0",
   "description": "React Native SDK for Koolbase \u2014 auth, database, storage, realtime, feature flags, and functions in one package.",
   "main": "./dist/cjs/index.js",
   "types": "./dist/esm/index.d.ts",
@@ -24,7 +24,7 @@
     "url": "https://github.com/koolbase/koolbase-react-native"
   },
   "dependencies": {
-    "@koolbase/core": "12.0.0"
+    "@koolbase/core": "12.2.0"
   },
   "peerDependencies": {
     "@react-native-async-storage/async-storage": "^3.0.2",