multimodel-dev-os 1.0.0 → 2.0.0

package/examples/expo-react-native-android/app.config.ts

@@ -0,0 +1,40 @@
+import { ExpoConfig, ConfigContext } from 'expo/config';
+
+/**
+ * Dynamic Expo App Configuration File
+ * Decouples staging/production URLs and binds environment variables at build-time.
+ */
+export default ({ config }: ConfigContext): ExpoConfig => {
+  const env = process.env.APP_ENV || 'development';
+
+  const extraConfig = {
+    development: {
+      apiUrl: 'http://10.0.2.2:3000/api', // Localhost mapping for Android Emulator loopbacks
+      envName: 'Development'
+    },
+    staging: {
+      apiUrl: 'https://staging-api.multimodel.dev',
+      envName: 'Staging'
+    },
+    production: {
+      apiUrl: 'https://api.multimodel.dev',
+      envName: 'Production'
+    }
+  };
+
+  const selectedEnv = extraConfig[env as keyof typeof extraConfig] || extraConfig.development;
+
+  return {
+    ...config,
+    name: config.name || "MultiModel Dev OS Mobile",
+    slug: config.slug || "multimodel-dev-os-mobile",
+    // Configure EAS parameters. Fill these in during local setup. Do not commit actual tokens to Git.
+    owner: "your-expo-username-placeholder",
+    extra: {
+      ...selectedEnv,
+      eas: {
+        projectId: "your-eas-project-id-placeholder"
+      }
+    }
+  };
+};

package/examples/expo-react-native-android/app.json

@@ -0,0 +1,34 @@
+{
+  "expo": {
+    "name": "MultiModel Dev OS Mobile",
+    "slug": "multimodel-dev-os-mobile",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/icon.png",
+    "userInterfaceStyle": "light",
+    "splash": {
+      "image": "./assets/splash.png",
+      "resizeMode": "contain",
+      "backgroundColor": "#ffffff"
+    },
+    "assetBundlePatterns": [
+      "**/*"
+    ],
+    "ios": {
+      "supportsTablet": true
+    },
+    "android": {
+      "adaptiveIcon": {
+        "foregroundImage": "./assets/adaptive-icon.png",
+        "backgroundColor": "#ffffff"
+      },
+      "package": "com.multimodel.devos",
+      "permissions": [
+        "INTERNET"
+      ]
+    },
+    "web": {
+      "favicon": "./assets/favicon.png"
+    }
+  }
+}

package/examples/expo-react-native-android/eas.json

@@ -0,0 +1,26 @@
+{
+  "cli": {
+    "version": ">= 9.0.0"
+  },
+  "build": {
+    "development": {
+      "developmentClient": true,
+      "distribution": "internal",
+      "channel": "development"
+    },
+    "preview": {
+      "distribution": "internal",
+      "channel": "preview"
+    },
+    "production": {
+      "distribution": "store",
+      "channel": "production",
+      "android": {
+        "buildType": "app-bundle"
+      }
+    }
+  },
+  "submit": {
+    "production": {}
+  }
+}

package/examples/expo-react-native-android/jest.config.js

@@ -0,0 +1,11 @@
+module.exports = {
+  preset: 'jest-expo',
+  transformIgnorePatterns: [
+    'node_modules/(?!((jest-)?react-native|@react-native(-community)?)|expo(nent)?|@expo(nent)?/.*|@expo-google-fonts/.*|react-navigation|@react-navigation/.*|@unimodules/.*|unimodules|sentry-expo|native-base|react-native-svg)'
+  ],
+  setupFilesAfterEnv: ["@testing-library/jest-native/extend-expect"],
+  testMatch: ['**/__tests__/**/*.test.[jt]s?(x)', '**/?(*.)+(spec|test).[jt]s?(x)'],
+  moduleNameMapper: {
+    '^@/(.*)$': '<rootDir>/src/$1'
+  }
+};

package/examples/expo-react-native-android/src/app/_layout.tsx

@@ -0,0 +1,89 @@
+import React, { useEffect, useState } from 'react';
+import { StyleSheet, Text, View, ActivityIndicator } from 'react-native';
+import NetInfo from '@react-native-community/netinfo';
+
+/**
+ * Root Application Layout Component
+ * Serves as the primary entry point for Expo Router.
+ * Resolves network connection states and establishes offline screen boundaries.
+ */
+export default function RootLayout() {
+  const [isConnected, setIsConnected] = useState<boolean | null>(true);
+  const [isLoading, setIsLoading] = useState<boolean>(true);
+
+  useEffect(() => {
+    // Monitor connection states dynamically across Android devices
+    const unsubscribe = NetInfo.addEventListener(state => {
+      setIsConnected(state.isConnected);
+      setIsLoading(false);
+    });
+
+    return () => unsubscribe();
+  }, []);
+
+  if (isLoading) {
+    return (
+      <View style={styles.center}>
+        <ActivityIndicator size="large" color="#6366f1" />
+      </View>
+    );
+  }
+
+  // Offline boundary gate: Render fallback UI if connection is lost
+  if (!isConnected) {
+    return (
+      <View style={styles.center}>
+        <Text style={styles.errorText}>No Internet Connection</Text>
+        <Text style={styles.subtext}>Please check your network settings and try again.</Text>
+      </View>
+    );
+  }
+
+  // Guidelines: For Expo Router navigation, replace the below container with:
+  //   import { Stack } from 'expo-router';
+  //   return <Stack screenOptions={{ headerShown: false }} />;
+  return (
+    <View style={styles.container}>
+      <Text style={styles.welcomeTitle}>MultiModel Dev OS Mobile</Text>
+      <Text style={styles.body}>Scaffolded React Native App Layout successfully mounted!</Text>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#f8fafc',
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: 24
+  },
+  center: {
+    flex: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: 24
+  },
+  welcomeTitle: {
+    fontSize: 24,
+    fontWeight: 'bold',
+    color: '#0f172a',
+    marginBottom: 8
+  },
+  body: {
+    fontSize: 16,
+    color: '#475569',
+    textAlign: 'center'
+  },
+  errorText: {
+    fontSize: 20,
+    fontWeight: 'bold',
+    color: '#ef4444',
+    marginBottom: 8
+  },
+  subtext: {
+    fontSize: 14,
+    color: '#64748b',
+    textAlign: 'center'
+  }
+});

package/examples/expo-react-native-android/src/lib/secure-storage.ts

@@ -0,0 +1,63 @@
+import * as SecureStore from 'expo-secure-store';
+
+/**
+ * Encrypted Key-Value Storage Wrapper
+ * Safely accesses expo-secure-store and runs assertions to verify key structures.
+ */
+export class SecureStorage {
+  static async setItem(key: string, value: string): Promise<boolean> {
+    if (!key || key.trim() === '') {
+      console.error('SecureStorage: Key cannot be empty');
+      return false;
+    }
+    try {
+      if (SecureStore && typeof SecureStore.setItemAsync === 'function') {
+        await SecureStore.setItemAsync(key, value);
+        return true;
+      } else {
+        console.warn(`[SecureStorage Mock] setItem: ${key} = ${value}`);
+        return true;
+      }
+    } catch (e) {
+      console.error(`Failed to set item in SecureStore for key: ${key}`, e);
+      return false;
+    }
+  }
+
+  static async getItem(key: string): Promise<string | null> {
+    if (!key || key.trim() === '') {
+      console.error('SecureStorage: Key cannot be empty');
+      return null;
+    }
+    try {
+      if (SecureStore && typeof SecureStore.getItemAsync === 'function') {
+        return await SecureStore.getItemAsync(key);
+      } else {
+        console.warn(`[SecureStorage Mock] getItem: ${key}`);
+        return null;
+      }
+    } catch (e) {
+      console.error(`Failed to retrieve item from SecureStore for key: ${key}`, e);
+      return null;
+    }
+  }
+
+  static async deleteItem(key: string): Promise<boolean> {
+    if (!key || key.trim() === '') {
+      console.error('SecureStorage: Key cannot be empty');
+      return false;
+    }
+    try {
+      if (SecureStore && typeof SecureStore.deleteItemAsync === 'function') {
+        await SecureStore.deleteItemAsync(key);
+        return true;
+      } else {
+        console.warn(`[SecureStorage Mock] deleteItem: ${key}`);
+        return true;
+      }
+    } catch (e) {
+      console.error(`Failed to delete item from SecureStore for key: ${key}`, e);
+      return false;
+    }
+  }
+}

package/examples/expo-react-native-android/src/services/api-client.ts

@@ -0,0 +1,106 @@
+import Constants from 'expo-constants';
+
+export interface ApiResponse<T> {
+  data: T | null;
+  error: string | null;
+  status: number;
+}
+
+export class ApiClient {
+  private baseUrl: string;
+  private timeoutMs: number = 10000;
+  private maxRetries: number = 3;
+  private useMockData: boolean = false; // Toggle true for offline mock validations
+
+  constructor() {
+    // Dynamically retrieve base API URL configured in app.config.ts extras
+    const extra = Constants.expoConfig?.extra || {};
+    this.baseUrl = extra.apiUrl || 'http://10.0.2.2:3000/api';
+  }
+
+  async request<T>(path: string, options: RequestInit = {}): Promise<ApiResponse<T>> {
+    if (this.useMockData) {
+      // Mock response resolver
+      return new Promise((resolve) => {
+        setTimeout(() => {
+          resolve({
+            data: { message: "Mock Success data from ApiClient" } as unknown as T,
+            error: null,
+            status: 200
+          });
+        }, 500);
+      });
+    }
+
+    const url = `${this.baseUrl}${path}`;
+    const defaultHeaders = {
+      'Content-Type': 'application/json',
+      'Accept': 'application/json'
+    };
+
+    let attempt = 0;
+    while (attempt < this.maxRetries) {
+      attempt++;
+      const controller = new AbortController();
+      const id = setTimeout(() => controller.abort(), this.timeoutMs);
+
+      try {
+        const response = await fetch(url, {
+          ...options,
+          headers: {
+            ...defaultHeaders,
+            ...options.headers
+          },
+          signal: controller.signal
+        });
+
+        clearTimeout(id);
+
+        // Retry on Server Error (5xx)
+        if (response.status >= 500 && attempt < this.maxRetries) {
+          console.warn(`[ApiClient] Attempt ${attempt} failed with status ${response.status}. Retrying...`);
+          continue;
+        }
+
+        if (!response.ok) {
+          return {
+            data: null,
+            error: `HTTP Error: ${response.status} ${response.statusText}`,
+            status: response.status
+          };
+        }
+
+        const data = await response.json();
+        return {
+          data: data as T,
+          error: null,
+          status: response.status
+        };
+      } catch (e: any) {
+        clearTimeout(id);
+        const isTimeout = e.name === 'AbortError';
+        
+        // Retry on timeout or transient network failures
+        if (attempt < this.maxRetries) {
+          console.warn(`[ApiClient] Attempt ${attempt} failed: ${e.message}. Retrying...`);
+          await new Promise((res) => setTimeout(res, 1000 * attempt)); // Exponential backoff
+          continue;
+        }
+
+        return {
+          data: null,
+          error: isTimeout ? 'Request Timeout' : e.message || 'Unknown network error',
+          status: 0
+        };
+      }
+    }
+
+    return {
+      data: null,
+      error: 'Max retries exceeded',
+      status: 0
+    };
+  }
+}
+
+export const apiClient = new ApiClient();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multimodel-dev-os",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "bin": {
     "multimodel-dev-os": "bin/multimodel-dev-os.js"
   },
@@ -45,7 +45,8 @@
     "pack": "bash scripts/pack-template.sh",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
-    "docs:preview": "vitepress preview docs"
+    "docs:preview": "vitepress preview docs",
+    "prepublishOnly": "node scripts/prepublish-guard.js"
   },
   "devDependencies": {
     "vitepress": "^1.6.4"