@thanhphi/create-360-miniapp 0.0.0-stage → 0.2.0

package/template/src/common/mini-app/provider.tsx

@@ -0,0 +1,44 @@
+import React from 'react';
+import { Provider } from 'react-redux';
+import { QueryClientProvider } from '@tanstack/react-query';
+import { GestureHandlerRootView } from 'react-native-gesture-handler';
+import { SafeAreaProvider } from 'react-native-safe-area-context';
+import { UIThemeProvider } from '@thanhphi/ui360';
+import { useUnistyles } from 'react-native-unistyles';
+import type {} from '../../themes';
+import type { ApplicationServices } from '../../services/application';
+
+const RuntimeContext = React.createContext<ApplicationServices | null>(null);
+
+export function useApplicationServices() {
+  const value = React.use(RuntimeContext);
+  if (!value) throw new Error('ApplicationProvider is required.');
+  return value;
+}
+
+export function ApplicationProvider({
+  services,
+  children,
+}: React.PropsWithChildren<{ services: ApplicationServices }>) {
+  const {
+    theme: { type, color, spacing, radius, typography },
+  } = useUnistyles();
+  // Read active tokens here so Unistyles tracks changes; never rebuild defaults.
+  const uiTheme = React.useMemo(
+    () => ({ mode: type, colors: color, spacing, radius, typography }),
+    [type, color, spacing, radius, typography],
+  );
+  return (
+    <GestureHandlerRootView style={{ flex: 1 }}>
+      <SafeAreaProvider>
+        <RuntimeContext value={services}>
+          <Provider store={services.store}>
+            <QueryClientProvider client={services.queryClient}>
+              <UIThemeProvider theme={uiTheme}>{children}</UIThemeProvider>
+            </QueryClientProvider>
+          </Provider>
+        </RuntimeContext>
+      </SafeAreaProvider>
+    </GestureHandlerRootView>
+  );
+}

package/template/src/common/mini-app/types.ts

@@ -0,0 +1,13 @@
+import type { HostCapabilities } from '@thanhphi/miniapp-sdk';
+
+export interface MiniAppProps {
+  /** Required hosted contract. Identity/tokens/refresh come from auth capabilities. */
+  hostCapabilities: HostCapabilities;
+  param_supper_app?: { notifications?: Record<string, unknown> };
+}
+
+export interface AuthActions {
+  isConfigured: boolean;
+  signIn(): Promise<void>;
+  signOut(): void;
+}

package/template/src/library/networking/client.ts

@@ -0,0 +1,53 @@
+import {
+  AuthError,
+  createHttpClient,
+  type AuthCapabilities,
+  type HttpRequestOptions,
+} from '@thanhphi/miniapp-sdk';
+import config from '@env-config';
+
+export function createApiClient(
+  auth: AuthCapabilities,
+  reportAuthError: (error: AuthError, sessionId: string | null) => void,
+) {
+  // Empty configuration must remain reviewable; no request is made until configured.
+  const http = config.BASE_URL.trim()
+    ? createHttpClient({
+        baseURL: config.BASE_URL,
+        timeoutMs: config.API_TIMEOUT_MS,
+        auth,
+      })
+    : null;
+  async function request<T>(
+    path: string,
+    options: HttpRequestOptions = {},
+  ): Promise<T> {
+    const before = auth.getSnapshot();
+    if (!before.sessionId || !before.accessToken)
+      throw new AuthError('expired');
+    if (!http)
+      throw new Error('Hãy cấu hình BASE_URL trong env trước khi gọi API.');
+    try {
+      const response = await http.request<T>(path, { ...options, auth: true });
+      return response.data;
+    } catch (error) {
+      if (error instanceof AuthError) reportAuthError(error, before.sessionId);
+      throw error;
+    }
+  }
+  return {
+    request,
+    get: <T>(path: string, options?: HttpRequestOptions) =>
+      request<T>(path, { ...options, method: 'GET' }),
+    post: <T>(path: string, options?: HttpRequestOptions) =>
+      request<T>(path, { ...options, method: 'POST' }),
+    put: <T>(path: string, options?: HttpRequestOptions) =>
+      request<T>(path, { ...options, method: 'PUT' }),
+    patch: <T>(path: string, options?: HttpRequestOptions) =>
+      request<T>(path, { ...options, method: 'PATCH' }),
+    delete: <T>(path: string, options?: HttpRequestOptions) =>
+      request<T>(path, { ...options, method: 'DELETE' }),
+    dispose: () => http?.dispose(),
+  };
+}
+export type ApiClient = ReturnType<typeof createApiClient>;

package/template/src/library/networking/errors.ts

@@ -0,0 +1,25 @@
+import { AuthError, HttpError } from '@thanhphi/miniapp-sdk';
+
+export function errorMessage(error: unknown): string {
+  if (error instanceof AuthError) {
+    if (error.kind === 'session-changed')
+      return 'Tài khoản đã thay đổi. Hãy tải lại dữ liệu.';
+    if (error.kind === 'expired')
+      return 'Phiên đăng nhập đã hết hạn. Hãy đăng nhập lại.';
+    return 'Không thể làm mới phiên. Hãy thử lại hoặc mở lại mini app.';
+  }
+  if (error instanceof HttpError) {
+    if (error.kind === 'timeout')
+      return 'Yêu cầu quá thời gian chờ. Hãy thử lại.';
+    if (error.kind === 'cancelled' || error.kind === 'disposed')
+      return 'Yêu cầu đã được huỷ.';
+    if (error.kind === 'http')
+      return `Máy chủ trả về lỗi ${error.status ?? ''}. Hãy thử lại.`;
+    if (error.kind === 'invalid-response')
+      return 'Dữ liệu trả về không đúng định dạng JSON.';
+    return 'Không thể kết nối máy chủ. Kiểm tra kết nối mạng rồi thử lại.';
+  }
+  return error instanceof Error
+    ? error.message
+    : 'Không thể hoàn tất yêu cầu. Hãy thử lại.';
+}

package/template/src/library/utils/responsive.ts

@@ -0,0 +1,7 @@
+import { Dimensions } from 'react-native';
+
+const DESIGN_WIDTH = 375;
+export const DEVICE_WIDTH = Dimensions.get('window').width;
+
+/** Use for exceptional app geometry only; theme tokens are already scaled. */
+export const ratioW = (value: number) => (value * DEVICE_WIDTH) / DESIGN_WIDTH;

package/template/src/modules/__MODULE__/components/ProfileCard.tsx

@@ -0,0 +1,37 @@
+import React from 'react';
+import { UIText } from '@thanhphi/ui360';
+import { View } from 'react-native';
+import { StyleSheet } from 'react-native-unistyles';
+import type {} from '../../../themes';
+import type { Profile } from '../services/profile.service';
+
+export function ProfileCard({ profile }: { profile: Profile }) {
+  return (
+    <View style={styles.card}>
+      <UIText selectable variant="title" weight="600">
+        {profile.name || 'Tài khoản'}
+      </UIText>
+      {profile.email && (
+        <UIText selectable color="content2">
+          {profile.email}
+        </UIText>
+      )}
+      {profile.id && (
+        <UIText selectable color="content2">
+          Mã: {profile.id}
+        </UIText>
+      )}
+    </View>
+  );
+}
+
+// Same guideline names as shared components; no per-component style hook.
+const styles = StyleSheet.create(({ color, spacing, radius }) => ({
+  card: {
+    padding: spacing.xxl,
+    gap: spacing.sm,
+    borderRadius: radius.lg,
+    borderCurve: 'continuous',
+    backgroundColor: color.background,
+  },
+}));

package/template/src/modules/__MODULE__/navigation/ModuleNavigator.tsx

@@ -0,0 +1,18 @@
+import React from 'react';
+import { createNativeStackNavigator } from '@react-navigation/native-stack';
+import HomeScreen from '../screens/home';
+
+export type ModuleStackParams = { Home: undefined };
+const Stack = createNativeStackNavigator<ModuleStackParams>();
+
+export default function ModuleNavigator() {
+  return (
+    <Stack.Navigator>
+      <Stack.Screen
+        name="Home"
+        component={HomeScreen}
+        options={{ title: '__DISPLAY_NAME__' }}
+      />
+    </Stack.Navigator>
+  );
+}

package/template/src/modules/__MODULE__/redux/home-slice.ts

@@ -0,0 +1,13 @@
+import { createSlice } from '@reduxjs/toolkit';
+
+const homeSlice = createSlice({
+  name: '__MODULE__',
+  initialState: { profileRequested: false },
+  reducers: {
+    profileRequested(state) {
+      state.profileRequested = true;
+    },
+  },
+});
+export const { profileRequested } = homeSlice.actions;
+export default homeSlice.reducer;

package/template/src/modules/__MODULE__/screens/home/hooks/use-home.ts

@@ -0,0 +1,30 @@
+import { useQuery } from '@tanstack/react-query';
+import { useApplicationServices } from '../../../../../common/mini-app/provider';
+import { useAppDispatch, useAppSelector } from '../../../../../redux/hooks';
+import {
+  selectIsAuthenticated,
+  selectSessionId,
+} from '../../../../auth/redux/selectors';
+import { profileRequested } from '../../../redux/home-slice';
+import { getProfile } from '../../../services/profile.service';
+
+export function useHome() {
+  const { api } = useApplicationServices();
+  const dispatch = useAppDispatch();
+  const sessionId = useAppSelector(selectSessionId);
+  const authenticated = useAppSelector(selectIsAuthenticated);
+  const requested = useAppSelector(state => state.home.profileRequested);
+  const query = useQuery({
+    queryKey: ['__MODULE__', 'profile', sessionId],
+    queryFn: ({ signal }) => getProfile(api, signal),
+    enabled: authenticated && requested,
+  });
+  return {
+    ...query,
+    requested,
+    loadProfile() {
+      if (requested) void query.refetch();
+      else dispatch(profileRequested());
+    },
+  };
+}

package/template/src/modules/__MODULE__/screens/home/index.tsx

@@ -0,0 +1,97 @@
+import React from 'react';
+import { Button, UIText } from '@thanhphi/ui360';
+import { ActivityIndicator, ScrollView, View } from 'react-native';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
+import { StyleSheet, useUnistyles } from 'react-native-unistyles';
+import { errorMessage } from '../../../../library/networking/errors';
+import type {} from '../../../../themes';
+import { useAuth } from '../../../auth/hooks/use-auth';
+import { ProfileCard } from '../../components/ProfileCard';
+import { useHome } from './hooks/use-home';
+
+export default function HomeScreen() {
+  const {
+    theme: { color, spacing },
+  } = useUnistyles();
+  const query = useHome();
+  const auth = useAuth();
+  const insets = useSafeAreaInsets();
+  return (
+    <ScrollView
+      contentInsetAdjustmentBehavior="automatic"
+      contentContainerStyle={[
+        styles.content,
+        { paddingBottom: insets.bottom + spacing.xxl },
+      ]}
+    >
+      {!query.requested && (
+        <View style={styles.intro}>
+          <UIText variant="title" weight="600" accessibilityRole="header">
+            Phiên đăng nhập đã sẵn sàng
+          </UIText>
+          <UIText color="content2">
+            Tải thông tin tài khoản khi bạn muốn kiểm tra kết nối.
+          </UIText>
+        </View>
+      )}
+      {query.isLoading && (
+        <ActivityIndicator
+          size="large"
+          color={color.primary500}
+          accessibilityLabel="Đang tải hồ sơ"
+        />
+      )}
+      {query.fetchStatus === 'paused' && (
+        <UIText selectable color="content2">
+          Kết nối đang tạm dừng. Thử lại khi có mạng.
+        </UIText>
+      )}
+      {query.error && (
+        <UIText selectable accessibilityRole="alert" color="danger">
+          {errorMessage(query.error)}
+        </UIText>
+      )}
+      {auth.message && (
+        <UIText selectable accessibilityRole="alert" color="danger">
+          {auth.message}
+        </UIText>
+      )}
+      {query.data === null && (
+        <UIText color="content2">
+          Chưa có thông tin tài khoản. Bạn có thể thử tải lại.
+        </UIText>
+      )}
+      {query.data && <ProfileCard profile={query.data} />}
+      <Button
+        label={
+          query.isFetching
+            ? 'Đang tải…'
+            : query.error
+            ? 'Thử lại'
+            : query.requested
+            ? 'Tải lại hồ sơ'
+            : 'Tải hồ sơ'
+        }
+        loading={query.isFetching}
+        onPress={query.loadProfile}
+      />
+      <Button
+        label={auth.isStandalone ? 'Đăng xuất khỏi ứng dụng' : 'Quay lại MySGR'}
+        onPress={() => {
+          if (auth.isStandalone) auth.signOut();
+          else void auth.closeMiniApp();
+        }}
+      />
+    </ScrollView>
+  );
+}
+
+const styles = StyleSheet.create(({ color, spacing }) => ({
+  content: {
+    padding: spacing.xxl,
+    gap: spacing.xxl,
+    flexGrow: 1,
+    backgroundColor: color.base3,
+  },
+  intro: { gap: spacing.lg },
+}));

package/template/src/modules/__MODULE__/services/profile.service.ts

@@ -0,0 +1,32 @@
+import type { ApiClient } from '../../../library/networking/client';
+
+export interface Profile {
+  id?: string;
+  name?: string;
+  email?: string;
+}
+
+/** Adapt this relative path and response shape to your backend before using it. */
+export const PROFILE_PATH = '/me';
+
+export async function getProfile(
+  api: ApiClient,
+  signal: AbortSignal,
+): Promise<Profile | null> {
+  const data = await api.get<unknown>(PROFILE_PATH, { signal });
+  if (data === null) return null;
+  if (typeof data !== 'object' || Array.isArray(data)) {
+    throw new Error(
+      'API hồ sơ cần trả về object hoặc null. Hãy cập nhật profile.service.ts theo backend.',
+    );
+  }
+  const value = data as Record<string, unknown>;
+  const stringValue = (key: string) =>
+    typeof value[key] === 'string' ? (value[key] as string) : undefined;
+  const profile = {
+    id: stringValue('id'),
+    name: stringValue('name'),
+    email: stringValue('email'),
+  };
+  return profile.id || profile.name || profile.email ? profile : null;
+}

package/template/src/modules/auth/hooks/use-auth.ts

@@ -0,0 +1,55 @@
+import React from 'react';
+import { useApplicationServices } from '../../../common/mini-app/provider';
+import { useAppSelector } from '../../../redux/hooks';
+import {
+  selectAuthMessage,
+  selectIsAuthenticated,
+  selectSessionId,
+} from '../redux/selectors';
+import { errorMessage } from '../../../library/networking/errors';
+
+export function useAuth() {
+  const { authActions, runtime } = useApplicationServices();
+  const authenticated = useAppSelector(selectIsAuthenticated);
+  const sessionId = useAppSelector(selectSessionId);
+  const sessionMessage = useAppSelector(selectAuthMessage);
+  const [pending, setPending] = React.useState(false);
+  const [message, setMessage] = React.useState<string | null>(null);
+  const mounted = React.useRef(true);
+  React.useEffect(() => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+    };
+  }, []);
+
+  const signIn = async () => {
+    if (!authActions || pending) return;
+    setPending(true);
+    setMessage(null);
+    try {
+      await authActions.signIn();
+    } catch (error) {
+      if (mounted.current) setMessage(errorMessage(error));
+    } finally {
+      if (mounted.current) setPending(false);
+    }
+  };
+  return {
+    authenticated,
+    sessionId,
+    message: message ?? sessionMessage,
+    pending,
+    isStandalone: Boolean(authActions),
+    canSignIn: Boolean(authActions?.isConfigured),
+    signIn,
+    signOut: () => authActions?.signOut(),
+    async closeMiniApp() {
+      try {
+        await runtime.capabilities.closeMiniApp();
+      } catch (error) {
+        if (mounted.current) setMessage(errorMessage(error));
+      }
+    },
+  };
+}

package/template/src/modules/auth/navigation/AuthenticationNavigator.tsx

@@ -0,0 +1,16 @@
+import React from 'react';
+import { createNativeStackNavigator } from '@react-navigation/native-stack';
+import LoginScreen from '../screens/LoginScreen';
+
+const Stack = createNativeStackNavigator<{ Login: undefined }>();
+export default function AuthenticationNavigator() {
+  return (
+    <Stack.Navigator>
+      <Stack.Screen
+        name="Login"
+        component={LoginScreen}
+        options={{ title: '__DISPLAY_NAME__' }}
+      />
+    </Stack.Navigator>
+  );
+}

package/template/src/modules/auth/redux/auth-slice.ts

@@ -0,0 +1,36 @@
+import { createSlice, type PayloadAction } from '@reduxjs/toolkit';
+
+export interface AuthState {
+  sessionId: string | null;
+  authenticated: boolean;
+  message: string | null;
+}
+const initialState: AuthState = {
+  sessionId: null,
+  authenticated: false,
+  message: null,
+};
+
+const authSlice = createSlice({
+  name: 'auth',
+  initialState,
+  reducers: {
+    sessionReceived(
+      state,
+      {
+        payload,
+      }: PayloadAction<Pick<AuthState, 'sessionId' | 'authenticated'>>,
+    ) {
+      state.sessionId = payload.sessionId;
+      state.authenticated = payload.authenticated;
+      state.message = null;
+    },
+    authenticationFailed(state, { payload }: PayloadAction<string>) {
+      state.authenticated = false;
+      state.message = payload;
+    },
+  },
+});
+
+export const { sessionReceived, authenticationFailed } = authSlice.actions;
+export default authSlice.reducer;

package/template/src/modules/auth/redux/selectors.ts

@@ -0,0 +1,6 @@
+import type { RootState } from '../../../redux/store';
+
+export const selectIsAuthenticated = (state: RootState) =>
+  state.auth.authenticated;
+export const selectSessionId = (state: RootState) => state.auth.sessionId;
+export const selectAuthMessage = (state: RootState) => state.auth.message;

package/template/src/modules/auth/screens/LoginScreen.tsx

@@ -0,0 +1,75 @@
+import React from 'react';
+import { Button, UIText } from '@thanhphi/ui360';
+import { ActivityIndicator, ScrollView, View } from 'react-native';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
+import { StyleSheet, useUnistyles } from 'react-native-unistyles';
+import type {} from '../../../themes';
+import { useAuth } from '../hooks/use-auth';
+
+export default function LoginScreen() {
+  const {
+    theme: { color, spacing },
+  } = useUnistyles();
+  const auth = useAuth();
+  const insets = useSafeAreaInsets();
+  return (
+    <ScrollView
+      contentInsetAdjustmentBehavior="automatic"
+      contentContainerStyle={[
+        styles.content,
+        { paddingBottom: insets.bottom + spacing.xxl },
+      ]}
+    >
+      <View style={styles.intro}>
+        <UIText variant="title" weight="600" accessibilityRole="header">
+          Đăng nhập để tiếp tục
+        </UIText>
+        <UIText color="content2">
+          {auth.isStandalone
+            ? auth.canSignIn
+              ? 'Đăng nhập bằng tài khoản được cấu hình cho ứng dụng.'
+              : 'Cấu hình issuer, clientId và redirectUrl trong env, rồi tạo lại native app để sử dụng OIDC.'
+            : 'Mini app cần phiên đăng nhập từ MySGR. Host phải hỗ trợ và truyền hostCapabilities theo contract SDK hiện tại.'}
+        </UIText>
+      </View>
+      {auth.message && (
+        <UIText selectable accessibilityRole="alert" color="danger">
+          {auth.message}
+        </UIText>
+      )}
+      {auth.pending && (
+        <ActivityIndicator
+          accessibilityLabel="Đang đăng nhập"
+          color={color.primary500}
+        />
+      )}
+      {auth.isStandalone ? (
+        <Button
+          label={auth.pending ? 'Đang đăng nhập…' : 'Đăng nhập'}
+          disabled={!auth.canSignIn}
+          loading={auth.pending}
+          onPress={() => {
+            void auth.signIn();
+          }}
+        />
+      ) : (
+        <Button
+          label="Quay lại MySGR"
+          onPress={() => {
+            void auth.closeMiniApp();
+          }}
+        />
+      )}
+    </ScrollView>
+  );
+}
+
+const styles = StyleSheet.create(({ color, spacing }) => ({
+  content: {
+    padding: spacing.xxl,
+    gap: spacing.xxl,
+    flexGrow: 1,
+    backgroundColor: color.base3,
+  },
+  intro: { gap: spacing.lg },
+}));

package/template/src/modules/auth/services/oidc.ts

@@ -0,0 +1,64 @@
+import {
+  authorize,
+  refresh,
+  type AuthConfiguration,
+} from 'react-native-app-auth';
+import { AuthError } from '@thanhphi/miniapp-sdk';
+import config from '@env-config';
+import type { OidcOperations } from './standalone-session';
+
+const authConfig: AuthConfiguration = {
+  issuer: config.AUTH.issuer,
+  clientId: config.AUTH.clientId,
+  redirectUrl: config.AUTH.redirectUrl,
+  scopes: [...config.AUTH.scopes],
+};
+
+export function isOidcConfigured(value: {
+  issuer: string;
+  clientId: string;
+  redirectUrl: string;
+  scopes: readonly string[];
+}): boolean {
+  const filled = (field: string) =>
+    Boolean(field.trim()) && !field.includes('YOUR_');
+  return (
+    filled(value.issuer) &&
+    filled(value.clientId) &&
+    filled(value.redirectUrl) &&
+    value.scopes.length > 0 &&
+    value.scopes.every(filled)
+  );
+}
+
+export const oidcOperations: OidcOperations = {
+  isConfigured: isOidcConfigured(config.AUTH),
+  async authorize() {
+    const result = await authorize(authConfig);
+    return {
+      accessToken: result.accessToken,
+      refreshToken: result.refreshToken || undefined,
+    };
+  },
+  async refresh(refreshToken) {
+    try {
+      const result = await refresh(authConfig, { refreshToken });
+      return {
+        accessToken: result.accessToken,
+        refreshToken: result.refreshToken || undefined,
+      };
+    } catch (error) {
+      if (error instanceof AuthError) throw error;
+      // AppAuth's documented OAuth token error for a revoked/expired refresh grant.
+      const code =
+        typeof error === 'object' && error !== null && 'code' in error
+          ? error.code
+          : undefined;
+      throw new AuthError(
+        code === 'invalid_grant' ? 'expired' : 'unavailable',
+        undefined,
+        error,
+      );
+    }
+  },
+};