@techfinityedge/koolbase-react-native 1.10.1 → 2.0.0

package/README.md

@@ -16,9 +16,9 @@ Auth, database, storage, realtime, functions, feature flags, remote config, vers
 3. Add the SDK:
 
 ```bash
-npm install @techfinityedge/koolbase-react-native@^1.10.0
+npm install @techfinityedge/koolbase-react-native@^2.0.0
 # or
-yarn add @techfinityedge/koolbase-react-native@^1.10.0
+yarn add @techfinityedge/koolbase-react-native@^2.0.0
 ```
 
 **4. Initialize at app startup:**
@@ -38,7 +38,7 @@ That's it. Every feature below is now available via `Koolbase.*`.
 
 ## Authentication
 
-Email + password, Apple Sign-In, and phone + OTP — out of the box.
+Email + password, Apple Sign-In, Google Sign-In, and phone + OTP — out of the box.
 
 ```typescript
 // Register
@@ -87,9 +87,28 @@ const session = await Koolbase.auth.signInWithApple({
 });
 ```
 
-Before users can sign in, configure Apple Sign-In for your environment with your iOS app's Bundle ID. Full setup guide at [docs.koolbase.com/auth/oauth](https://docs.koolbase.com/auth/oauth).
+Configure Apple Sign-In for your environment with your iOS app's Bundle ID. Full setup guide at [docs.koolbase.com/auth/oauth](https://docs.koolbase.com/auth/oauth).
 
-> **Google Sign-In** — coming in v1.11.0.
+### OAuth — Google
+
+Google Sign-In uses the native authentication flow via `@react-native-google-signin/google-signin` as a peer dependency:
+
+```typescript
+import { GoogleSignin } from '@react-native-google-signin/google-signin';
+import { Koolbase } from '@techfinityedge/koolbase-react-native';
+
+GoogleSignin.configure({
+  webClientId: '<your-web-client-id>.apps.googleusercontent.com',
+});
+
+const userInfo = await GoogleSignin.signIn();
+
+const session = await Koolbase.auth.signInWithGoogle({
+  idToken: userInfo.idToken!,
+});
+```
+
+Configure Google Sign-In for your environment with the OAuth client IDs from Google Cloud Console (typically one each for iOS, Android, and web). Full setup guide at [docs.koolbase.com/auth/oauth](https://docs.koolbase.com/auth/oauth).
 
 ### Phone + OTP
 
@@ -128,6 +147,11 @@ const { records } = await Koolbase.db.query('posts', {
   orderDesc: true,
 });
 
+// Read fields off a record
+const post = records[0];
+console.log(post.data.title);          // your fields live under .data
+console.log(post.id, post.collection); // metadata
+
 // Populate related records
 const { records: postsWithAuthor } = await Koolbase.db.query('posts', {
   populate: ['author_id:users'],

package/dist/auth-errors.d.ts

@@ -106,3 +106,12 @@ export declare class AppleEmailRequiredError extends KoolbaseAuthError {
 export declare class OAuthEmailConflictError extends KoolbaseAuthError {
     constructor();
 }
+export declare class GoogleSignInNotConfiguredError extends KoolbaseAuthError {
+    constructor();
+}
+export declare class InvalidGoogleTokenError extends KoolbaseAuthError {
+    constructor();
+}
+export declare class GoogleEmailRequiredError extends KoolbaseAuthError {
+    constructor();
+}

package/dist/auth-errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OAuthEmailConflictError = exports.AppleEmailRequiredError = exports.InvalidAppleTokenError = exports.AppleSignInNotConfiguredError = exports.SmsConfigMissingError = exports.PhoneAlreadyLinkedError = exports.OtpRateLimitError = exports.OtpMaxAttemptsError = exports.OtpInvalidError = exports.OtpExpiredError = exports.InvalidPhoneNumberError = exports.NetworkError = exports.RateLimitError = exports.UnlockTokenInvalidError = exports.AccountLockedError = exports.TokenRevokedError = exports.SessionExpiredError = exports.WeakPasswordError = exports.UserDisabledError = exports.EmailAlreadyInUseError = exports.InvalidCredentialsError = exports.KoolbaseAuthError = void 0;
+exports.GoogleEmailRequiredError = exports.InvalidGoogleTokenError = exports.GoogleSignInNotConfiguredError = exports.OAuthEmailConflictError = exports.AppleEmailRequiredError = exports.InvalidAppleTokenError = exports.AppleSignInNotConfiguredError = exports.SmsConfigMissingError = exports.PhoneAlreadyLinkedError = exports.OtpRateLimitError = exports.OtpMaxAttemptsError = exports.OtpInvalidError = exports.OtpExpiredError = exports.InvalidPhoneNumberError = exports.NetworkError = exports.RateLimitError = exports.UnlockTokenInvalidError = exports.AccountLockedError = exports.TokenRevokedError = exports.SessionExpiredError = exports.WeakPasswordError = exports.UserDisabledError = exports.EmailAlreadyInUseError = exports.InvalidCredentialsError = exports.KoolbaseAuthError = void 0;
 /**
  * Base error type for all Koolbase auth errors. Catchable via
  * `instanceof KoolbaseAuthError` to handle any auth-related failure
@@ -224,3 +224,27 @@ class OAuthEmailConflictError extends KoolbaseAuthError {
     }
 }
 exports.OAuthEmailConflictError = OAuthEmailConflictError;
+class GoogleSignInNotConfiguredError extends KoolbaseAuthError {
+    constructor() {
+        super('Google Sign-In is not configured for this environment', 'google_not_configured');
+        this.name = 'GoogleSignInNotConfiguredError';
+        Object.setPrototypeOf(this, GoogleSignInNotConfiguredError.prototype);
+    }
+}
+exports.GoogleSignInNotConfiguredError = GoogleSignInNotConfiguredError;
+class InvalidGoogleTokenError extends KoolbaseAuthError {
+    constructor() {
+        super('Invalid Google identity token', 'invalid_google_token');
+        this.name = 'InvalidGoogleTokenError';
+        Object.setPrototypeOf(this, InvalidGoogleTokenError.prototype);
+    }
+}
+exports.InvalidGoogleTokenError = InvalidGoogleTokenError;
+class GoogleEmailRequiredError extends KoolbaseAuthError {
+    constructor() {
+        super('Google did not return email for this sign-in. Ensure the email scope is requested in the native flow.', 'google_email_required');
+        this.name = 'GoogleEmailRequiredError';
+        Object.setPrototypeOf(this, GoogleEmailRequiredError.prototype);
+    }
+}
+exports.GoogleEmailRequiredError = GoogleEmailRequiredError;

package/dist/auth.d.ts

@@ -1,4 +1,5 @@
 import { AuthStateListener, KoolbaseConfig, KoolbaseSession, KoolbaseUser, LinkPhoneParams, LoginParams, OtpSendResult, PhoneVerifyResult, RegisterParams, RestoreResult, SendOtpParams, SignInWithAppleParams, VerifyOtpParams } from './types';
+import type { SignInWithGoogleParams } from './types';
 export declare class KoolbaseAuth {
     private config;
     private storage;
@@ -85,6 +86,35 @@ export declare class KoolbaseAuth {
    *   but auto-link rule blocked (409).
    */
     signInWithApple(params: SignInWithAppleParams): Promise<KoolbaseSession>;
+    /**
+     * Sign in with Google using an idToken from a native Google Sign-In SDK.
+     *
+     * The SDK is library-agnostic — use any native Google Sign-In package
+     * (`@react-native-google-signin/google-signin`, etc.) and pass the
+     * resulting `idToken`. Google embeds the user's name and email in the
+     * idToken itself, so this method does not take a `fullName` parameter
+     * (unlike `signInWithApple`).
+     *
+     * On success the session is persisted via the configured storage and
+     * `onAuthStateChange` fires with the resolved user.
+     *
+     * @throws GoogleSignInNotConfiguredError when Google is not enabled
+     *   in the OAuth config for this environment (400).
+     * @throws InvalidGoogleTokenError when the token signature, audience,
+     *   expiry, replay, or nonce check failed server-side (401).
+     * @throws UserDisabledError when the account flag is set to disabled (403).
+     * @throws GoogleEmailRequiredError when Google did not return email
+     *   for a new-account sign-in (400).
+     * @throws OAuthEmailConflictError when email matches existing user
+     *   but auto-link rule blocked (409).
+     */
+    signInWithGoogle(params: SignInWithGoogleParams): Promise<KoolbaseSession>;
+    /**
+     * Parses a /v1/sdk/auth/oauth/google response. Distinct from
+     * parseSessionResponse and parseAppleSessionResponse because OAuth
+     * error semantics differ per-provider.
+     */
+    private parseGoogleSessionResponse;
     /**
      * Parses a /v1/sdk/auth/oauth/apple response. Distinct from
      * parseSessionResponse because OAuth error semantics differ from

package/dist/auth.js

@@ -259,6 +259,85 @@ class KoolbaseAuth {
         await this.setSessionInternal(session);
         return session;
     }
+    /**
+     * Sign in with Google using an idToken from a native Google Sign-In SDK.
+     *
+     * The SDK is library-agnostic — use any native Google Sign-In package
+     * (`@react-native-google-signin/google-signin`, etc.) and pass the
+     * resulting `idToken`. Google embeds the user's name and email in the
+     * idToken itself, so this method does not take a `fullName` parameter
+     * (unlike `signInWithApple`).
+     *
+     * On success the session is persisted via the configured storage and
+     * `onAuthStateChange` fires with the resolved user.
+     *
+     * @throws GoogleSignInNotConfiguredError when Google is not enabled
+     *   in the OAuth config for this environment (400).
+     * @throws InvalidGoogleTokenError when the token signature, audience,
+     *   expiry, replay, or nonce check failed server-side (401).
+     * @throws UserDisabledError when the account flag is set to disabled (403).
+     * @throws GoogleEmailRequiredError when Google did not return email
+     *   for a new-account sign-in (400).
+     * @throws OAuthEmailConflictError when email matches existing user
+     *   but auto-link rule blocked (409).
+     */
+    async signInWithGoogle(params) {
+        const body = {
+            identity_token: params.idToken,
+        };
+        if (params.nonce && params.nonce.length > 0) {
+            body.nonce = params.nonce;
+        }
+        const res = await this.authRequest('/v1/sdk/auth/oauth/google', {
+            method: 'POST',
+            body,
+        });
+        const session = await this.parseGoogleSessionResponse(res);
+        await this.setSessionInternal(session);
+        return session;
+    }
+    /**
+     * Parses a /v1/sdk/auth/oauth/google response. Distinct from
+     * parseSessionResponse and parseAppleSessionResponse because OAuth
+     * error semantics differ per-provider.
+     */
+    async parseGoogleSessionResponse(res) {
+        if (res.status === 200) {
+            const data = await res.json();
+            return {
+                accessToken: data.access_token,
+                refreshToken: data.refresh_token,
+                expiresAt: data.expires_at,
+                user: this.mapUser(data.user),
+            };
+        }
+        let errorMessage = '';
+        try {
+            const data = await res.json();
+            errorMessage = data?.error ?? '';
+        }
+        catch {
+            // best-effort error message extraction
+        }
+        if (res.status === 400) {
+            if (errorMessage.includes('not configured')) {
+                throw new auth_errors_1.GoogleSignInNotConfiguredError();
+            }
+            if (errorMessage.includes('did not return email')) {
+                throw new auth_errors_1.GoogleEmailRequiredError();
+            }
+            throw new auth_errors_1.KoolbaseAuthError(`google sign-in failed: ${errorMessage}`, 'google_signin_failed');
+        }
+        if (res.status === 401)
+            throw new auth_errors_1.InvalidGoogleTokenError();
+        if (res.status === 403)
+            throw new auth_errors_1.UserDisabledError();
+        if (res.status === 409)
+            throw new auth_errors_1.OAuthEmailConflictError();
+        if (res.status === 429)
+            throw new auth_errors_1.RateLimitError(errorMessage);
+        throw new auth_errors_1.KoolbaseAuthError(`google sign-in failed: ${res.status} ${errorMessage}`, `google_signin_http_${res.status}`);
+    }
     /**
      * Parses a /v1/sdk/auth/oauth/apple response. Distinct from
      * parseSessionResponse because OAuth error semantics differ from

package/dist/database.d.ts

@@ -6,6 +6,7 @@ export declare class KoolbaseDatabase {
     constructor(config: KoolbaseConfig, getUserId: () => string | null);
     private get headers();
     private request;
+    private runQuery;
     query(collection: string, options?: QueryOptions): Promise<QueryResult>;
     insert(collection: string, data: Record<string, unknown>): Promise<KoolbaseRecord>;
     get(recordId: string): Promise<KoolbaseRecord>;

package/dist/database.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.KoolbaseDatabase = void 0;
 const cache_store_1 = require("./cache-store");
 const sync_engine_1 = require("./sync-engine");
+const record_1 = require("./record");
 function generateId() {
     return 'local_' + Math.random().toString(36).slice(2) + Date.now().toString(36);
 }
@@ -34,13 +35,8 @@ class KoolbaseDatabase {
         return data;
     }
     // ─── Query (cache-first) ───────────────────────────────────────────────────
-    async query(collection, options = {}) {
-        const userId = this.getUserId() ?? 'anonymous';
-        const queryHash = (0, cache_store_1.hashQuery)(collection, options);
-        // 1. Return cached data immediately if available
-        const cached = await (0, cache_store_1.getCached)(userId, collection, queryHash);
-        // 2. Fetch from network in background
-        this.request('POST', '/v1/sdk/db/query', {
+    async runQuery(collection, options) {
+        const raw = await this.request('POST', '/v1/sdk/db/query', {
             collection,
             filters: options.filters ?? {},
             limit: options.limit ?? 20,
@@ -48,26 +44,22 @@ class KoolbaseDatabase {
             order_by: options.orderBy,
             order_desc: options.orderDesc ?? false,
             populate: options.populate ?? [],
-        })
-            .then(async (result) => {
-            await (0, cache_store_1.setCached)(userId, collection, queryHash, result);
-        })
+        });
+        return { records: raw.records.map(record_1.recordFromWire), total: raw.total };
+    }
+    async query(collection, options = {}) {
+        const userId = this.getUserId() ?? 'anonymous';
+        const queryHash = (0, cache_store_1.hashQuery)(collection, options);
+        const cached = await (0, cache_store_1.getCached)(userId, collection, queryHash);
+        this.runQuery(collection, options)
+            .then(result => (0, cache_store_1.setCached)(userId, collection, queryHash, result))
             .catch(() => {
-            // Network unavailable — cached data is already returned
+            // Network unavailable — cached data already returned
         });
         if (cached) {
             return { ...cached, isFromCache: true };
         }
-        // No cache — wait for network
-        const result = await this.request('POST', '/v1/sdk/db/query', {
-            collection,
-            filters: options.filters ?? {},
-            limit: options.limit ?? 20,
-            offset: options.offset ?? 0,
-            order_by: options.orderBy,
-            order_desc: options.orderDesc ?? false,
-            populate: options.populate ?? [],
-        });
+        const result = await this.runQuery(collection, options);
         await (0, cache_store_1.setCached)(userId, collection, queryHash, result);
         return { ...result, isFromCache: false };
     }
@@ -77,8 +69,6 @@ class KoolbaseDatabase {
         // Build optimistic record
         const optimisticRecord = {
             id: generateId(),
-            projectId: '',
-            collectionId: '',
             createdBy: userId,
             data,
             createdAt: new Date().toISOString(),
@@ -109,29 +99,25 @@ class KoolbaseDatabase {
     }
     // ─── Get single record ──────────────────────────────────────────────────────
     async get(recordId) {
-        return this.request('GET', `/v1/sdk/db/records/${recordId}`);
+        const raw = await this.request('GET', `/v1/sdk/db/records/${recordId}`);
+        return (0, record_1.recordFromWire)(raw);
     }
     // ─── Update ─────────────────────────────────────────────────────────────────
     async update(recordId, data) {
         const userId = this.getUserId() ?? 'anonymous';
-        // Add to write queue
         await (0, cache_store_1.addToWriteQueue)(userId, {
             id: generateId(),
             type: 'update',
             recordId,
             data,
         });
-        // Try network
         try {
-            const result = await this.request('PATCH', `/v1/sdk/db/records/${recordId}`, { data });
-            return result;
+            const raw = await this.request('PATCH', `/v1/sdk/db/records/${recordId}`, { data });
+            return (0, record_1.recordFromWire)(raw);
         }
         catch {
-            // Return optimistic version
             return {
                 id: recordId,
-                projectId: '',
-                collectionId: '',
                 data,
                 createdAt: '',
                 updatedAt: new Date().toISOString(),

package/dist/device-metadata.d.ts

@@ -4,7 +4,7 @@
  * version-conditional logic (deprecation warnings, schema migrations,
  * feature flags). Must match the `version` field in package.json.
  */
-export declare const koolbaseSdkVersion = "1.10.1";
+export declare const koolbaseSdkVersion = "1.11.0";
 /**
  * Builds device-identifying headers attached to every Koolbase auth
  * request. Mirrors the Flutter SDK's `DeviceMetadata` for parity. Apps

package/dist/device-metadata.js

@@ -9,7 +9,7 @@ const auth_storage_1 = require("./auth-storage");
  * version-conditional logic (deprecation warnings, schema migrations,
  * feature flags). Must match the `version` field in package.json.
  */
-exports.koolbaseSdkVersion = '1.10.1';
+exports.koolbaseSdkVersion = '1.11.0';
 /**
  * Generate a UUIDv4-shaped string for use as a stable per-install
  * device label. Not cryptographically secure — this is a label, not a

package/dist/realtime.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KoolbaseRealtime = void 0;
+const record_1 = require("./record");
 class KoolbaseRealtime {
     constructor(config) {
         this.ws = null;
@@ -31,7 +32,14 @@ class KoolbaseRealtime {
         this.ws = new WebSocket(`${wsUrl}/v1/sdk/realtime?key=${this.config.publicKey}`);
         this.ws.onmessage = (event) => {
             try {
-                const msg = JSON.parse(event.data);
+                const raw = JSON.parse(event.data);
+                if (!raw || !raw.record)
+                    return;
+                const msg = {
+                    type: raw.type,
+                    collection: raw.collection,
+                    record: (0, record_1.recordFromWire)(raw.record),
+                };
                 const callbacks = this.listeners.get(msg.collection) ?? [];
                 callbacks.forEach((cb) => cb(msg));
             }

package/dist/record.d.ts

@@ -0,0 +1,2 @@
+import { KoolbaseRecord } from './types';
+export declare function recordFromWire(raw: Record<string, unknown>): KoolbaseRecord;

package/dist/record.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordFromWire = recordFromWire;
+// Converts the flat public wire shape into a KoolbaseRecord.
+// Server sends: { $id, $createdAt, $updatedAt, $collection, $createdBy?, ...fields }
+function recordFromWire(raw) {
+    const data = {};
+    for (const key of Object.keys(raw)) {
+        if (!key.startsWith('$'))
+            data[key] = raw[key];
+    }
+    return {
+        id: raw['$id'],
+        collection: raw['$collection'],
+        createdBy: raw['$createdBy'],
+        data,
+        createdAt: raw['$createdAt'],
+        updatedAt: raw['$updatedAt'],
+    };
+}

package/dist/types.d.ts

@@ -111,8 +111,7 @@ export interface PhoneVerifyResult {
 }
 export interface KoolbaseRecord {
     id: string;
-    projectId: string;
-    collectionId: string;
+    collection?: string;
     createdBy?: string;
     data: Record<string, unknown>;
     createdAt: string;
@@ -224,3 +223,15 @@ export interface SignInWithAppleParams {
     nonce?: string;
     fullName?: AppleFullName;
 }
+/**
+ * Parameters for `KoolbaseAuth.signInWithGoogle`. The SDK is
+ * library-agnostic — `idToken` should come from any native Google
+ * Sign-In package (e.g. `@react-native-google-signin/google-signin`).
+ *
+ * Unlike Apple, Google embeds the user's name and email in the idToken
+ * itself, so no separate `fullName` parameter is needed.
+ */
+export interface SignInWithGoogleParams {
+    idToken: string;
+    nonce?: string;
+}

package/package.json

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