@techfinityedge/koolbase-react-native 2.3.0 → 2.4.0

package/README.md

@@ -323,6 +323,30 @@ Koolbase.codePush.applyDirectives();
 
 ---
 
+### Mandatory updates
+
+Mark a bundle **mandatory** in the dashboard (or via `PATCH /mandatory`) when every device must apply it before continuing — surfaced as a push callback and a pollable flag:
+
+```typescript
+await Koolbase.initialize({
+  publicKey: 'pk_live_xxxx',
+  baseUrl: 'https://api.koolbase.com',
+  // Fires the moment a mandatory bundle is staged for the next launch
+  onMandatoryUpdate: ({ version }) => {
+    showRestartRequiredDialog(version);
+  },
+});
+
+// Or poll it — e.g. on app resume — before letting the user proceed
+if (Koolbase.codePush.hasMandatoryUpdate) {
+  showRestartRequiredDialog();
+}
+```
+
+A mandatory bundle still activates on the next cold launch like any other; the callback and flag just let you prompt the user to restart now instead of waiting.
+
+---
+
 ## Logic Engine
 
 Define conditional app behavior as data in your Runtime Bundle — no code changes required.
@@ -442,7 +466,7 @@ try {
 
 ## What's included
 
-- Authentication: email + password, Apple Sign-In, phone + OTP
+- Authentication: email + password, Apple Sign-In, Google Sign-In, phone + OTP
 - Database with offline-first cache, realtime subscriptions, and populate
 - Storage with download URLs
 - Realtime subscriptions over WebSocket

package/dist/code-push.d.ts

@@ -23,11 +23,13 @@ export interface BundleManifest {
     signature: string;
     size_bytes: number;
     payload: BundlePayload;
+    mandatory?: boolean;
 }
 export declare class KoolbaseCodePush {
     private config;
     private channel;
     private activeManifest;
+    private mandatoryPending;
     constructor(config: KoolbaseConfig, channel?: string);
     init(options: {
         appVersion: string;
@@ -40,6 +42,12 @@ export declare class KoolbaseCodePush {
     private download;
     private handleRollback;
     get hasActiveBundle(): boolean;
+    /**
+     * True when a mandatory bundle has been staged this session and is awaiting
+     * application (it activates on the next cold launch). Gate your UI on this to
+     * prompt the user to restart so the required update takes effect.
+     */
+    get hasMandatoryUpdate(): boolean;
     get manifest(): BundleManifest | null;
     getBundleConfig(key: string): unknown | undefined;
     getBundleFlag(key: string): boolean | undefined;

package/dist/code-push.js

@@ -72,6 +72,7 @@ async function extractManifestFromZip(data) {
 class KoolbaseCodePush {
     constructor(config, channel = 'stable') {
         this.activeManifest = null;
+        this.mandatoryPending = false;
         // ─── Directive handling ──────────────────────────────────────────────────
         this.directiveHandlers = new Map();
         this.config = config;
@@ -178,9 +179,21 @@ class KoolbaseCodePush {
                 console.warn('[KoolbaseCodePush] manifest extraction failed');
                 return;
             }
+            // Carry the mandatory flag from the check response onto the staged manifest
+            manifest.mandatory = ref.mandatory;
             // Store as pending — activates on next launch
             await async_storage_1.default.setItem(STORAGE_KEY_PENDING, JSON.stringify(manifest));
             console.log(`[KoolbaseCodePush] bundle v${manifest.version} ready for next launch`);
+            if (ref.mandatory) {
+                this.mandatoryPending = true;
+                console.log('[KoolbaseCodePush] staged bundle is mandatory — notifying app');
+                try {
+                    this.config.onMandatoryUpdate?.({ version: manifest.version, bundleId: manifest.bundle_id });
+                }
+                catch (cbErr) {
+                    console.warn('[KoolbaseCodePush] onMandatoryUpdate handler threw:', cbErr);
+                }
+            }
         }
         catch (e) {
             console.warn('[KoolbaseCodePush] download error:', e);
@@ -197,6 +210,14 @@ class KoolbaseCodePush {
     get hasActiveBundle() {
         return this.activeManifest !== null;
     }
+    /**
+     * True when a mandatory bundle has been staged this session and is awaiting
+     * application (it activates on the next cold launch). Gate your UI on this to
+     * prompt the user to restart so the required update takes effect.
+     */
+    get hasMandatoryUpdate() {
+        return this.mandatoryPending;
+    }
     get manifest() {
         return this.activeManifest;
     }

package/dist/types.d.ts

@@ -2,6 +2,10 @@ export interface KoolbaseConfig {
     publicKey: string;
     baseUrl: string;
     codePushChannel?: string;
+    onMandatoryUpdate?: (info: {
+        version: number;
+        bundleId: string;
+    }) => void;
     analyticsEnabled?: boolean;
     appVersion?: string;
     messagingEnabled?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techfinityedge/koolbase-react-native",
-  "version": "2.3.0",
+  "version": "2.4.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",