@techfinityedge/koolbase-react-native 1.6.1 → 1.8.0

package/README.md

@@ -1,4 +1,16 @@
-# koolbase-react-native
+# Koolbase React Native SDK
+
+⚠️ ## This package has moved
+
+This package is deprecated.
+
+👉 Install the official version:
+
+```bash
+npm install @techfinityedge/koolbase-react-native
+```
+
+---
 
 [![npm](https://img.shields.io/npm/v/koolbase-react-native.svg)](https://www.npmjs.com/package/koolbase-react-native)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -11,11 +23,12 @@ Auth, database, storage, realtime, functions, feature flags, remote config, vers
 
 ## Get started in 2 minutes
 
-**1. Create a free account at [app.koolbase.com](https://app.koolbase.com)**
+1. Create a free account at [app.koolbase.com](https://app.koolbase.com)
+
+2. Create a project and copy your public key from Environments
 
-**2. Create a project and copy your public key from Environments**
+3. Add the SDK:
 
-**3. Add the SDK:**
 ```bash
 npm install koolbase-react-native
 # or
@@ -23,6 +36,7 @@ yarn add koolbase-react-native
 ```
 
 **4. Initialize at app startup:**
+
 ```typescript
 import { Koolbase } from 'koolbase-react-native';
 
@@ -37,6 +51,7 @@ That's it. Every feature below is now available via `Koolbase.*`.
 ---
 
 ## Authentication
+
 ```typescript
 // Register
 await Koolbase.auth.register({ email: 'user@example.com', password: 'password' });
@@ -57,6 +72,7 @@ await Koolbase.auth.forgotPassword('user@example.com');
 ---
 
 ## Database
+
 ```typescript
 // Insert
 await Koolbase.db.insert('posts', { title: 'Hello', published: true });
@@ -80,6 +96,7 @@ await Koolbase.db.delete('record-id');
 ```
 
 ### Offline-first
+
 ```typescript
 const { records, isFromCache } = await Koolbase.db.query('posts', { limit: 20 });
 if (isFromCache) console.log('Served from local cache');
@@ -90,6 +107,7 @@ await Koolbase.db.syncPendingWrites();
 ---
 
 ## Storage
+
 ```typescript
 const { url } = await Koolbase.storage.upload({
   bucket: 'avatars',
@@ -104,6 +122,7 @@ await Koolbase.storage.delete('avatars', `user-${userId}.jpg`);
 ---
 
 ## Realtime
+
 ```typescript
 const unsubscribe = Koolbase.realtime.subscribe('messages', (event) => {
   if (event.type === 'created') setMessages(prev => [event.record, ...prev]);
@@ -116,6 +135,7 @@ unsubscribe();
 ---
 
 ## Feature Flags & Remote Config
+
 ```typescript
 if (Koolbase.isEnabled('new_checkout')) { ... }
 
@@ -127,6 +147,7 @@ const dark = Koolbase.configBool('force_dark_mode', false);
 ---
 
 ## Version Enforcement
+
 ```typescript
 const result = Koolbase.checkVersion('1.2.3');
 if (result.status === 'force_update') {
@@ -137,6 +158,7 @@ if (result.status === 'force_update') {
 ---
 
 ## Code Push
+
 ```typescript
 await Koolbase.initialize({
   publicKey: 'pk_live_xxxx',
@@ -157,6 +179,7 @@ Koolbase.codePush.applyDirectives();
 ---
 
 ## Logic Engine
+
 ```typescript
 // Define flows in your bundle's flows.json
 // Execute from anywhere in your app
@@ -173,6 +196,7 @@ if (result.hasEvent) {
 ---
 
 ## Analytics
+
 ```typescript
 await Koolbase.initialize({
   publicKey: 'pk_live_xxxx',
@@ -198,6 +222,7 @@ Koolbase.analytics.reset();
 ---
 
 ## Cloud Messaging
+
 ```typescript
 await Koolbase.initialize({
   publicKey: 'pk_live_xxxx',

package/dist/auth-errors.d.ts

@@ -0,0 +1,25 @@
+export declare class KoolbaseAuthError extends Error {
+    code?: string;
+    constructor(message: string, code?: string);
+}
+export declare class InvalidPhoneNumberError extends KoolbaseAuthError {
+    constructor();
+}
+export declare class OtpExpiredError extends KoolbaseAuthError {
+    constructor();
+}
+export declare class OtpInvalidError extends KoolbaseAuthError {
+    constructor();
+}
+export declare class OtpMaxAttemptsError extends KoolbaseAuthError {
+    constructor();
+}
+export declare class OtpRateLimitError extends KoolbaseAuthError {
+    constructor();
+}
+export declare class PhoneAlreadyLinkedError extends KoolbaseAuthError {
+    constructor();
+}
+export declare class SmsConfigMissingError extends KoolbaseAuthError {
+    constructor();
+}

package/dist/auth-errors.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmsConfigMissingError = exports.PhoneAlreadyLinkedError = exports.OtpRateLimitError = exports.OtpMaxAttemptsError = exports.OtpInvalidError = exports.OtpExpiredError = exports.InvalidPhoneNumberError = exports.KoolbaseAuthError = void 0;
+class KoolbaseAuthError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'KoolbaseAuthError';
+        Object.setPrototypeOf(this, KoolbaseAuthError.prototype);
+    }
+}
+exports.KoolbaseAuthError = KoolbaseAuthError;
+class InvalidPhoneNumberError extends KoolbaseAuthError {
+    constructor() {
+        super('Phone number must be in E.164 format (e.g. +233XXXXXXXXX)', 'invalid_phone');
+        this.name = 'InvalidPhoneNumberError';
+        Object.setPrototypeOf(this, InvalidPhoneNumberError.prototype);
+    }
+}
+exports.InvalidPhoneNumberError = InvalidPhoneNumberError;
+class OtpExpiredError extends KoolbaseAuthError {
+    constructor() {
+        super('OTP has expired, please request a new code', 'otp_expired');
+        this.name = 'OtpExpiredError';
+        Object.setPrototypeOf(this, OtpExpiredError.prototype);
+    }
+}
+exports.OtpExpiredError = OtpExpiredError;
+class OtpInvalidError extends KoolbaseAuthError {
+    constructor() {
+        super('Invalid OTP code', 'otp_invalid');
+        this.name = 'OtpInvalidError';
+        Object.setPrototypeOf(this, OtpInvalidError.prototype);
+    }
+}
+exports.OtpInvalidError = OtpInvalidError;
+class OtpMaxAttemptsError extends KoolbaseAuthError {
+    constructor() {
+        super('Too many incorrect attempts, please request a new code', 'otp_max_attempts');
+        this.name = 'OtpMaxAttemptsError';
+        Object.setPrototypeOf(this, OtpMaxAttemptsError.prototype);
+    }
+}
+exports.OtpMaxAttemptsError = OtpMaxAttemptsError;
+class OtpRateLimitError extends KoolbaseAuthError {
+    constructor() {
+        super('Too many OTP requests, please wait before trying again', 'otp_rate_limit');
+        this.name = 'OtpRateLimitError';
+        Object.setPrototypeOf(this, OtpRateLimitError.prototype);
+    }
+}
+exports.OtpRateLimitError = OtpRateLimitError;
+class PhoneAlreadyLinkedError extends KoolbaseAuthError {
+    constructor() {
+        super('Phone number is already associated with another account', 'phone_taken');
+        this.name = 'PhoneAlreadyLinkedError';
+        Object.setPrototypeOf(this, PhoneAlreadyLinkedError.prototype);
+    }
+}
+exports.PhoneAlreadyLinkedError = PhoneAlreadyLinkedError;
+class SmsConfigMissingError extends KoolbaseAuthError {
+    constructor() {
+        super('SMS provider not configured for this project', 'sms_config_missing');
+        this.name = 'SmsConfigMissingError';
+        Object.setPrototypeOf(this, SmsConfigMissingError.prototype);
+    }
+}
+exports.SmsConfigMissingError = SmsConfigMissingError;

package/dist/auth.d.ts

@@ -1,4 +1,4 @@
-import { KoolbaseConfig, KoolbaseSession, KoolbaseUser, LoginParams, RegisterParams } from './types';
+import { KoolbaseConfig, KoolbaseSession, KoolbaseUser, LinkPhoneParams, LoginParams, OtpSendResult, PhoneVerifyResult, RegisterParams, SendOtpParams, VerifyOtpParams } from './types';
 export declare class KoolbaseAuth {
     private config;
     private session;
@@ -21,4 +21,9 @@ export declare class KoolbaseAuth {
         name?: string;
         avatarUrl?: string;
     }): Promise<Record<string, unknown> | null>;
+    sendOtp(params: SendOtpParams): Promise<OtpSendResult>;
+    verifyOtp(params: VerifyOtpParams): Promise<PhoneVerifyResult>;
+    linkPhone(params: LinkPhoneParams): Promise<void>;
+    private validatePhone;
+    private parsePhoneResponse;
 }

package/dist/auth.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KoolbaseAuth = void 0;
+const auth_errors_1 = require("./auth-errors");
 class KoolbaseAuth {
     constructor(config) {
         this.session = null;
@@ -81,5 +82,93 @@ class KoolbaseAuth {
             return null;
         }
     }
+    async sendOtp(params) {
+        this.validatePhone(params.phoneNumber);
+        const res = await fetch(`${this.config.baseUrl}/v1/sdk/auth/phone/send-otp`, {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify({ phone_number: params.phoneNumber }),
+        });
+        const data = await this.parsePhoneResponse(res);
+        return { expiresAt: data.expires_at };
+    }
+    async verifyOtp(params) {
+        this.validatePhone(params.phoneNumber);
+        const res = await fetch(`${this.config.baseUrl}/v1/sdk/auth/phone/verify-otp`, {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify({
+                phone_number: params.phoneNumber,
+                code: params.code,
+            }),
+        });
+        const data = await this.parsePhoneResponse(res);
+        const user = {
+            id: data.user.id,
+            email: data.user.email ?? '',
+            phoneNumber: data.user.phone_number,
+            phoneVerified: data.user.phone_verified ?? false,
+            fullName: data.user.full_name,
+            avatarUrl: data.user.avatar_url,
+            verified: data.user.verified ?? false,
+            createdAt: data.user.created_at,
+        };
+        const session = {
+            accessToken: data.access_token,
+            refreshToken: data.refresh_token,
+            user,
+        };
+        this.session = session;
+        return { session, isNewUser: data.is_new_user ?? false };
+    }
+    async linkPhone(params) {
+        if (!this.session) {
+            throw new auth_errors_1.KoolbaseAuthError('Must be signed in to link a phone number', 'unauthenticated');
+        }
+        this.validatePhone(params.phoneNumber);
+        const res = await fetch(`${this.config.baseUrl}/v1/sdk/auth/phone/link`, {
+            method: 'POST',
+            headers: this.authHeaders,
+            body: JSON.stringify({
+                phone_number: params.phoneNumber,
+                code: params.code,
+            }),
+        });
+        await this.parsePhoneResponse(res);
+    }
+    validatePhone(phoneNumber) {
+        if (!/^\+[1-9]\d{6,14}$/.test(phoneNumber)) {
+            throw new auth_errors_1.InvalidPhoneNumberError();
+        }
+    }
+    async parsePhoneResponse(res) {
+        let body = {};
+        try {
+            body = await res.json();
+        }
+        catch { }
+        if (res.ok)
+            return body;
+        const msg = body.error ?? '';
+        if (res.status === 429)
+            throw new auth_errors_1.OtpRateLimitError();
+        if (res.status === 409)
+            throw new auth_errors_1.PhoneAlreadyLinkedError();
+        if (msg.includes('E.164'))
+            throw new auth_errors_1.InvalidPhoneNumberError();
+        if (msg.includes('OTP has expired'))
+            throw new auth_errors_1.OtpExpiredError();
+        if (msg.includes('too many incorrect attempts')) {
+            throw new auth_errors_1.OtpMaxAttemptsError();
+        }
+        if (msg.includes('invalid OTP') ||
+            msg.includes('invalid or expired OTP')) {
+            throw new auth_errors_1.OtpInvalidError();
+        }
+        if (msg.includes('SMS provider not configured')) {
+            throw new auth_errors_1.SmsConfigMissingError();
+        }
+        throw new auth_errors_1.KoolbaseAuthError(msg || 'An unexpected error occurred');
+    }
 }
 exports.KoolbaseAuth = KoolbaseAuth;

package/dist/functions.d.ts

@@ -1,7 +1,8 @@
 import { KoolbaseConfig, FunctionInvokeResult, DeployOptions, DeployResult } from './types';
 export declare class KoolbaseFunctions {
     private config;
-    constructor(config: KoolbaseConfig);
+    private getUserAccessToken?;
+    constructor(config: KoolbaseConfig, getUserAccessToken?: () => string | null);
     deploy(options: DeployOptions): Promise<DeployResult>;
     invoke(name: string, body?: Record<string, unknown>): Promise<FunctionInvokeResult>;
 }

package/dist/functions.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.KoolbaseFunctions = void 0;
 const types_1 = require("./types");
 class KoolbaseFunctions {
-    constructor(config) {
+    constructor(config, getUserAccessToken) {
         this.config = config;
+        this.getUserAccessToken = getUserAccessToken;
     }
     // ─── Deploy ────────────────────────────────────────────────────────────────
     async deploy(options) {
@@ -40,12 +41,17 @@ class KoolbaseFunctions {
     }
     // ─── Invoke ────────────────────────────────────────────────────────────────
     async invoke(name, body) {
+        const headers = {
+            'Content-Type': 'application/json',
+            'x-api-key': this.config.publicKey,
+        };
+        const userToken = this.getUserAccessToken?.();
+        if (userToken) {
+            headers['Authorization'] = `Bearer ${userToken}`;
+        }
         const res = await fetch(`${this.config.baseUrl}/v1/sdk/functions/${name}`, {
             method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'x-api-key': this.config.publicKey,
-            },
+            headers,
             body: JSON.stringify({ body: body ?? {} }),
         });
         const data = await res.json().catch(() => null);

package/dist/index.d.ts

@@ -17,6 +17,7 @@ import { KoolbaseRealtime } from './realtime';
 import { KoolbaseStorage } from './storage';
 import { KoolbaseConfig, VersionCheckResult } from './types';
 export * from './types';
+export * from './auth-errors';
 export { KoolbaseAuth, KoolbaseDatabase, KoolbaseFlags, KoolbaseFunctions, KoolbaseRealtime, KoolbaseStorage };
 export declare const Koolbase: {
     initialize(config: KoolbaseConfig): Promise<void>;

package/dist/index.js

@@ -44,6 +44,7 @@ Object.defineProperty(exports, "KoolbaseRealtime", { enumerable: true, get: func
 const storage_1 = require("./storage");
 Object.defineProperty(exports, "KoolbaseStorage", { enumerable: true, get: function () { return storage_1.KoolbaseStorage; } });
 __exportStar(require("./types"), exports);
+__exportStar(require("./auth-errors"), exports);
 let _auth = null;
 let _db = null;
 let _storage = null;
@@ -68,7 +69,7 @@ exports.Koolbase = {
         _db = new database_1.KoolbaseDatabase(config, () => _auth?.currentUser?.id ?? null);
         _storage = new storage_1.KoolbaseStorage(config, () => _auth?.accessToken ?? null);
         _realtime = new realtime_1.KoolbaseRealtime(config);
-        _functions = new functions_1.KoolbaseFunctions(config);
+        _functions = new functions_1.KoolbaseFunctions(config, () => _auth?.accessToken ?? null);
         _flags = new flags_1.KoolbaseFlags(config, 'rn-device');
         _codePush = new code_push_1.KoolbaseCodePush(config, config.codePushChannel ?? 'stable');
         // Initialize code push — loads cached bundle then checks in background

package/dist/types.d.ts

@@ -9,6 +9,8 @@ export interface KoolbaseConfig {
 export interface KoolbaseUser {
     id: string;
     email: string;
+    phoneNumber?: string;
+    phoneVerified?: boolean;
     fullName?: string;
     avatarUrl?: string;
     verified: boolean;
@@ -28,6 +30,24 @@ export interface LoginParams {
     email: string;
     password: string;
 }
+export interface SendOtpParams {
+    phoneNumber: string;
+}
+export interface VerifyOtpParams {
+    phoneNumber: string;
+    code: string;
+}
+export interface LinkPhoneParams {
+    phoneNumber: string;
+    code: string;
+}
+export interface OtpSendResult {
+    expiresAt: string;
+}
+export interface PhoneVerifyResult {
+    session: KoolbaseSession;
+    isNewUser: boolean;
+}
 export interface KoolbaseRecord {
     id: string;
     projectId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techfinityedge/koolbase-react-native",
-  "version": "1.6.1",
+  "version": "1.8.0",
   "description": "React Native SDK for Koolbase — auth, database, storage, realtime, feature flags, and functions in one package.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",