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

package/template/README.md

@@ -0,0 +1,215 @@
+# __DISPLAY_NAME__
+
+Mini app TypeScript chạy trong MySGR qua Re.Pack. Chạy độc lập bằng Expo là lựa chọn phục vụ phát triển và kiểm thử.
+
+## Thông tin project
+
+| Cấu hình | Giá trị |
+| --- | --- |
+| npm package / thư mục | `__PACKAGE_NAME__` |
+| Container Re.Pack | `__APP_NAME__` |
+| Module được expose | `__APP_NAME__/MiniApp` |
+| App ID trong catalog | `__APP_ID__` |
+| App code | `__APP_CODE__` |
+| Module nghiệp vụ | `src/modules/__MODULE__` |
+| Port local | `__PORT__` |
+| Bundle ID standalone | `__BUNDLE_ID__` |
+
+Yêu cầu Node.js >=20.19.4, khuyến nghị Node 22 LTS. Bộ phiên bản được khai báo trong package.json: Expo 55, React Native 0.83.6, React 19.2.0, UI360 0.2.0, Unistyles 3.2.5 và Nitro 0.36.5. Không tự nâng riêng React/native dependencies nếu host chưa hỗ trợ phiên bản đó.
+
+## 1. Cài dependencies và chọn môi trường
+
+```sh
+npm install
+npm run env:staging
+```
+
+Commit package-lock.json sau lần cài đầu. Các lần sau dùng npm ci.
+
+Sửa env/staging.json, env/beta.json và env/prod.json:
+
+- BASE_URL: URL gốc của backend.
+- API_TIMEOUT_MS: timeout của request.
+- AUTH: cấu hình OIDC khi chạy độc lập.
+
+Script env sinh env/env-config.ts; không sửa file sinh bằng tay. Đổi môi trường cần restart dev server.
+
+Tất cả giá trị env đi vào bundle. Không lưu client secret, mật khẩu hoặc token trong JSON. Secret deployment phải đặt trong CI.
+
+## 2. Chạy trong MySGR
+
+**Hosted** nghĩa là mở mini app bên trong MySGR. Host cung cấp phiên đăng nhập và các native modules.
+
+```sh
+npm run env:staging
+npm run start:mf
+```
+
+Đăng ký app phía host/catalog theo bảng đầu tài liệu, trỏ resolver tới dev server port __PORT__, sau đó mở app từ MySGR. CLI không tự sửa repository host hoặc dữ liệu backend.
+
+Thiết bị thật cần IP LAN của máy phát triển:
+
+```sh
+npm run start:mf:device
+```
+
+Nếu cần reset cache dev server:
+
+```sh
+npm run start:mf:reset
+```
+
+Host phải truyền hostCapabilities theo miniapp-sdk. Base đã nối sẵn auth.getSnapshot/subscribe/refreshIfNeeded và closeMiniApp; màn hình/service không cần tự lưu token hoặc đăng nhập lại.
+
+- Host quản lý refresh token và persistence.
+- Mini app không persist token do host cấp.
+- Đổi tài khoản làm đổi session và xóa dữ liệu phiên cũ.
+- Refresh access token trong cùng session không reset dữ liệu nghiệp vụ.
+- param_supper_app dùng cho dữ liệu mở app/thông báo, không thay cho auth.
+- Thiếu hostCapabilities là lỗi cấu hình tích hợp; không tự chuyển sang standalone login.
+
+## 3. Chạy độc lập để phát triển
+
+**Standalone** nghĩa là chạy app riêng, không nằm trong MySGR. Cần Xcode/CocoaPods cho iOS hoặc Android SDK/JDK cho Android; template không chạy bằng Expo Go.
+
+Đăng ký OAuth native client với provider, cấu hình issuer/clientId/scopes và redirect URL trong env. Redirect mặc định có dạng __BUNDLE_ID__.auth://oauth/redirect.
+
+```sh
+npm run env:staging
+npx expo prebuild
+npm run ios:staging
+# Hoặc npm run android:staging
+```
+
+Đã có development build thì dùng npm run start:staging để chạy Metro. Có các lệnh tương ứng với beta và prod.
+
+Token standalone mặc định chỉ ở bộ nhớ; khởi động lại sẽ mất phiên. Scopes OIDC mẫu không tự cấp quyền API. Nếu backend yêu cầu token exchange, bổ sung flow đó trong service auth. Không dùng ID token thay API access token.
+
+Đổi redirect URL hoặc thêm native dependency cần cập nhật native build.
+
+## 4. Nơi thêm code
+
+```text
+env/                          Cấu hình staging, beta, prod
+pipelines/                    CI và deployment Azure
+src/
+  common/mini-app/            Provider, runtime, host integration
+  library/networking/        HTTP client
+  modules/auth/              Phiên đăng nhập
+  modules/__MODULE__/
+    screens/                 Màn hình và hooks
+    navigation/              Routes của module
+    services/                Endpoints và mapping response
+    redux/                   State nghiệp vụ
+  navigation/                Root navigator
+  services/application.ts    Khởi tạo client/store/QueryClient
+  themes/                    Palette, geometry, standalone setup
+```
+
+Đặt tính năng mới trong src/modules/__MODULE__, đăng ký route trong navigator của module. Không đặt endpoints trong root provider.
+
+### API và dữ liệu mẫu
+
+Màn Home chỉ gọi API sau khi nhấn **Tải hồ sơ**. Chỉnh PROFILE_PATH và mapping response trong src/modules/__MODULE__/services/profile.service.ts theo backend thật; endpoint mẫu là /me.
+
+Lấy client qua useApplicationServices() trong component/hook, rồi truyền client vào service:
+
+```ts
+import type { ApiClient } from '../../../library/networking/client';
+
+export function getItems(api: ApiClient, signal?: AbortSignal) {
+  return api.get<{ id: string; name: string }[]>('/items', { signal });
+}
+```
+
+Ví dụ này giả định response là array trực tiếp; unwrap envelope trong service nếu backend trả cấu trúc khác. HTTP client tự gắn access token và refresh/retry tối đa một lần sau HTTP 401.
+
+Mẫu useHome() có QueryClient, request cancellation và session trong query key; dùng làm mẫu cho dữ liệu cá nhân. Nếu backend báo hết hạn token trong HTTP 200, cấu hình isAuthExpired tại src/library/networking/client.ts.
+
+## 5. Màu và geometry
+
+Unistyles phục vụ style của app; UIThemeProvider phục vụ component từ UI360.
+
+- Hosted giữ nguyên mode và color từ runtime host.
+- UI360 được bundle trong mini app, không share implementation với host.
+- Geometry mặc định được tạo bằng factory UI360 tại src/themes/ui-geometry.ts. Màn mẫu và provider dùng cùng spacing/radius/typography, không yêu cầu host có những trường này.
+- Palette local tại src/themes/colors/light.ts và dark.ts dùng để cấu hình standalone.
+- Không mapping key màu legacy, không trộn palette và không ghi đè theme global khi hosted.
+- Tách phiên bản UI360 không tự tách runtime Unistyles. Host vẫn cần có tên token màu mà app sử dụng.
+
+Ví dụ style:
+
+```tsx
+import { StyleSheet } from 'react-native-unistyles';
+import { uiGeometry } from './themes/ui-geometry';
+
+const { spacing, radius } = uiGeometry;
+const styles = StyleSheet.create(({ color }) => ({
+  card: {
+    backgroundColor: color.background,
+    padding: spacing.xxl,
+    borderRadius: radius.lg,
+  },
+}));
+```
+
+Điều chỉnh import theo vị trí file. content1 là chữ nội dung, textPrimary là chữ trên primary; background là nền card, base3 là nền màn. Geometry đã scale theo thiết kế rộng 375, không nhân scale lại.
+
+Để đổi geometry, cấu hình tại ui-geometry.ts. Override số truyền vào factory là dp và không bị scale lại. createUITheme/create360Theme chỉ tạo object; chỉ entry standalone mới gọi StyleSheet.configure qua src/themes/standalone.ts.
+
+## 6. Đóng gói remote
+
+```sh
+npm run env:staging
+npm run bundle:mf:android
+npm run bundle:mf:ios
+```
+
+Deploy các thư mục:
+
+```text
+build/outputs/android/remotes/
+build/outputs/ios/remotes/
+```
+
+ZIP toàn bộ nội dung remotes của mỗi platform, gồm __APP_NAME__.container.js.bundle và các chunk, bỏ các file .map. Không chỉ upload container. Không dùng build/generated/<platform>/index.bundle để triển khai mini app.
+
+Các lệnh này tạo JavaScript/assets, không tạo IPA/APK. Các native dependencies vẫn phải có trong binary host.
+
+## 7. CI và deployment
+
+Azure DevOps có pipelines/staging.yml, beta.yml và production.yml. Mặc định deploy=false: cài dependencies, kiểm tra, build remote, ZIP và lưu artifacts.
+
+Muốn bật deploy, cấu hình service connection/variable group và các biến:
+
+| Biến | Mục đích |
+| --- | --- |
+| MINIAPP_AZURE_SUBSCRIPTION | Azure service connection |
+| MINIAPP_STORAGE_ACCOUNT | Storage Account |
+| MINIAPP_STORAGE_CONTAINER | Blob container |
+| DB_HOST, DB_LOGIN, DB_DATABASE | PostgreSQL catalog |
+| DB_PASSWORD | Mật khẩu, đánh dấu secret |
+
+Kiểm tra appName/appId/appCode, envBuild/envFolder và miniAppVersion trong YAML. Agent deploy cần Azure CLI, psql và quyền mạng tới hạ tầng. Pipeline không tự tạo hạ tầng, schema database hoặc đăng ký app trong source host.
+
+## 8. Kiểm tra trước khi phát hành
+
+```sh
+npm run typecheck
+npm run lint
+npm test
+```
+
+Sau đó thử trên host: mở/đóng app, refresh token, đổi tài khoản, lỗi mạng, dialog/loading, theme và artifact hai platform.
+
+| Vấn đề | Kiểm tra |
+| --- | --- |
+| Không tải remote | Container name, module name, URL/port và đủ chunk |
+| Thiếu hostCapabilities | Props/cách host mở mini app |
+| Không có spacing.xxl | Dùng uiGeometry/UIThemeProvider, không đọc geometry thiếu từ host |
+| Màu thiếu hoặc không đúng | Token màu trong theme Unistyles đang hoạt động |
+| Standalone không đăng nhập | OAuth client, redirect URL, scopes, native build |
+| API vẫn trả 401 | API audience/scopes hoặc token exchange |
+| Lỗi native module | Binary host có module/phiên bản cần dùng chưa |
+
+Hướng dẫn tạo project mới và các CLI options: [@thanhphi/create-360-miniapp trên npm](https://www.npmjs.com/package/@thanhphi/create-360-miniapp).

package/template/__tests__/auth.test.ts

@@ -0,0 +1,287 @@
+import {
+  AuthError,
+  HttpError,
+  type HostCapabilities,
+  type SessionSnapshot,
+} from '@thanhphi/miniapp-sdk';
+import {
+  createStandaloneSession,
+  type OidcTokens,
+} from '../src/modules/auth/services/standalone-session';
+import { createApplicationServices } from '../src/services/application';
+import { profileRequested } from '../src/modules/__MODULE__/redux/home-slice';
+import { refresh as nativeRefresh } from 'react-native-app-auth';
+import {
+  isOidcConfigured,
+  oidcOperations,
+} from '../src/modules/auth/services/oidc';
+
+jest.mock('react-native-app-auth', () => ({
+  authorize: jest.fn(),
+  refresh: jest.fn(),
+}));
+jest.mock('@env-config', () => ({
+  __esModule: true,
+  default: {
+    ENV: 'staging',
+    BASE_URL: 'https://api.example.test',
+    API_TIMEOUT_MS: 1000,
+    AUTH: { issuer: '', clientId: '', redirectUrl: '', scopes: ['openid'] },
+  },
+}));
+
+function deferred<T>() {
+  let resolve!: (value: T) => void;
+  let reject!: (error: unknown) => void;
+  const promise = new Promise<T>((yes, no) => {
+    resolve = yes;
+    reject = no;
+  });
+  return { promise, resolve, reject };
+}
+
+function testHost(initial: SessionSnapshot) {
+  let value = initial;
+  const listeners = new Set<(snapshot: SessionSnapshot) => void>();
+  const capabilities: HostCapabilities = {
+    auth: {
+      getSnapshot: () => ({ ...value }),
+      refreshIfNeeded: jest.fn(async () => value.accessToken),
+      subscribe(listener) {
+        listeners.add(listener);
+        return () => {
+          listeners.delete(listener);
+        };
+      },
+    },
+    closeMiniApp: jest.fn(),
+  };
+  return {
+    capabilities,
+    listeners,
+    emit(next: SessionSnapshot) {
+      value = next;
+      for (const listener of listeners) listener({ ...next });
+    },
+  };
+}
+
+describe('standalone session', () => {
+  test('rejects example OIDC values and maps revoked grants distinctly from network failures', async () => {
+    expect(
+      isOidcConfigured({
+        issuer: 'https://YOUR_OIDC_ISSUER',
+        clientId: 'YOUR_CLIENT_ID',
+        redirectUrl: 'sample://oauth',
+        scopes: ['openid'],
+      }),
+    ).toBe(false);
+    expect(
+      isOidcConfigured({
+        issuer: 'https://identity.example.test',
+        clientId: 'mobile',
+        redirectUrl: 'sample://oauth',
+        scopes: ['openid'],
+      }),
+    ).toBe(true);
+    const native = jest.mocked(nativeRefresh);
+    native.mockRejectedValueOnce({ code: 'invalid_grant' });
+    await expect(oidcOperations.refresh('revoked')).rejects.toMatchObject({
+      kind: 'expired',
+    });
+    native.mockRejectedValueOnce({ code: 'token_refresh_failed' });
+    await expect(oidcOperations.refresh('offline')).rejects.toMatchObject({
+      kind: 'unavailable',
+    });
+  });
+  test('coalesces a refresh and blocks its token write after local logout', async () => {
+    const response = deferred<OidcTokens>();
+    const refresh = jest.fn(() => response.promise);
+    const session = createStandaloneSession({
+      isConfigured: true,
+      authorize: async () => ({
+        accessToken: 'first-token',
+        refreshToken: 'private-refresh',
+      }),
+      refresh,
+    });
+    await session.actions.signIn();
+    const before = session.capabilities.auth.getSnapshot();
+    const first = session.capabilities.auth.refreshIfNeeded({
+      sessionId: before.sessionId,
+      failedAccessToken: before.accessToken,
+    });
+    const second = session.capabilities.auth.refreshIfNeeded({
+      sessionId: before.sessionId,
+      failedAccessToken: before.accessToken,
+    });
+    expect(first).toBe(second);
+    await Promise.resolve();
+    expect(refresh).toHaveBeenCalledTimes(1);
+    const checked = expect(first).rejects.toMatchObject({
+      kind: 'session-changed',
+    });
+    session.actions.signOut();
+    response.resolve({
+      accessToken: 'old-account-token',
+      refreshToken: 'old-refresh',
+    });
+    await checked;
+    expect(session.capabilities.auth.getSnapshot()).toEqual({
+      sessionId: null,
+      accessToken: null,
+    });
+    session.dispose();
+  });
+
+  test('blocks a late login result after logout', async () => {
+    const response = deferred<OidcTokens>();
+    const session = createStandaloneSession({
+      isConfigured: true,
+      authorize: () => response.promise,
+      refresh: jest.fn(),
+    });
+    const login = session.actions.signIn();
+    await Promise.resolve();
+    const checked = expect(login).rejects.toMatchObject({
+      kind: 'session-changed',
+    });
+    session.actions.signOut();
+    response.resolve({ accessToken: 'late-token' });
+    await checked;
+    expect(session.capabilities.auth.getSnapshot().accessToken).toBeNull();
+    session.dispose();
+  });
+
+  test('requires configured OIDC and never synthesizes credentials', async () => {
+    const authorize = jest.fn();
+    const session = createStandaloneSession({
+      isConfigured: false,
+      authorize,
+      refresh: jest.fn(),
+    });
+    await expect(session.actions.signIn()).rejects.toBeInstanceOf(AuthError);
+    expect(authorize).not.toHaveBeenCalled();
+    expect(session.capabilities.auth.getSnapshot()).toEqual({
+      sessionId: null,
+      accessToken: null,
+    });
+    session.dispose();
+  });
+});
+
+describe('application resources', () => {
+  const clients: ReturnType<typeof createApplicationServices>[] = [];
+  const originalFetch = globalThis.fetch;
+  beforeEach(() => {
+    globalThis.fetch = jest.fn();
+  });
+  afterEach(() => {
+    clients.splice(0).forEach(client => client.dispose());
+    globalThis.fetch = originalFetch;
+  });
+  const create = (host: HostCapabilities) => {
+    const client = createApplicationServices(host);
+    clients.push(client);
+    return client;
+  };
+
+  test('isolates instances; rotation retains caches; account change resets Redux and queries', () => {
+    const host = testHost({ sessionId: 'alice', accessToken: 'first-token' });
+    const first = create(host.capabilities);
+    const second = create(host.capabilities);
+    first.store.dispatch(profileRequested());
+    first.queryClient.setQueryData(['profile', 'alice'], { name: 'Alice' });
+    expect(second.store.getState().home.profileRequested).toBe(false);
+    expect(
+      second.queryClient.getQueryData(['profile', 'alice']),
+    ).toBeUndefined();
+    expect(first.store.getState().auth).not.toHaveProperty('accessToken');
+    expect(JSON.stringify(first.store.getState())).not.toContain('first-token');
+    const dispatched = jest.spyOn(first.store, 'dispatch');
+    host.emit({ sessionId: 'alice', accessToken: 'rotated-token' });
+    expect(JSON.stringify(dispatched.mock.calls)).not.toContain(
+      'rotated-token',
+    );
+    expect(JSON.stringify(first.store.getState())).not.toContain('rotated-token');
+    expect(first.queryClient.getQueryData(['profile', 'alice'])).toEqual({
+      name: 'Alice',
+    });
+    expect(first.store.getState().home.profileRequested).toBe(true);
+    host.emit({ sessionId: 'bob', accessToken: 'bob-token' });
+    expect(
+      first.queryClient.getQueryData(['profile', 'alice']),
+    ).toBeUndefined();
+    expect(first.store.getState().home.profileRequested).toBe(false);
+    expect(first.store.getState().auth.sessionId).toBe('bob');
+    expect(JSON.stringify(first.store.getState())).not.toContain('bob-token');
+  });
+
+  test('dispose cancels a pending HTTP request, removes subscriptions and permits a fresh mount', async () => {
+    globalThis.fetch = jest.fn(() => new Promise<Response>(() => {}));
+    const host = testHost({ sessionId: 'alice', accessToken: 'alice-token' });
+    const first = create(host.capabilities);
+    const request = first.api.get('/me');
+    const checked = expect(request).rejects.toMatchObject({
+      kind: 'disposed',
+    } satisfies Partial<HttpError>);
+    await Promise.resolve();
+    first.dispose();
+    await checked;
+    expect(host.listeners.size).toBe(0);
+    expect(first.store.getState().auth.authenticated).toBe(false);
+    const next = create(host.capabilities);
+    expect(next.store.getState().auth.authenticated).toBe(true);
+    expect(next.store).not.toBe(first.store);
+    expect(host.listeners.size).toBe(1);
+  });
+
+  test('HTTP 401 retries once then clears user state when refresh still expires', async () => {
+    const unauthorized = {
+      status: 401,
+      ok: false,
+      headers: new Headers(),
+      url: '',
+      text: async () => '{}',
+    } as Response;
+    globalThis.fetch = jest.fn(async () => unauthorized);
+    const host = testHost({ sessionId: 'alice', accessToken: 'alice-token' });
+    const client = create(host.capabilities);
+    client.store.dispatch(profileRequested());
+    client.queryClient.setQueryData(['profile', 'alice'], { name: 'Alice' });
+    await expect(client.api.get('/me')).rejects.toMatchObject({
+      kind: 'expired',
+    });
+    expect(globalThis.fetch).toHaveBeenCalledTimes(2);
+    expect(client.store.getState().home.profileRequested).toBe(false);
+    expect(
+      client.queryClient.getQueryData(['profile', 'alice']),
+    ).toBeUndefined();
+    expect(client.store.getState().auth.authenticated).toBe(false);
+    expect(client.store.getState().auth.message).toContain('hết hạn');
+  });
+
+  test('all HTTP verbs inject the current host token and return parsed data', async () => {
+    const response = {
+      status: 200,
+      ok: true,
+      headers: new Headers(),
+      url: '',
+      text: async () => '{"ok":true}',
+    } as Response;
+    const fetch = jest.fn(async () => response);
+    globalThis.fetch = fetch;
+    const host = testHost({ sessionId: 'alice', accessToken: 'alice-token' });
+    const client = create(host.capabilities);
+    for (const method of ['get', 'post', 'put', 'patch', 'delete'] as const) {
+      await expect(client.api[method]('/me')).resolves.toEqual({ ok: true });
+      const [, init] = fetch.mock.calls[
+        fetch.mock.calls.length - 1
+      ] as unknown as [string, RequestInit];
+      expect(init.method).toBe(method.toUpperCase());
+      expect(new Headers(init.headers).get('Authorization')).toBe(
+        'Bearer alice-token',
+      );
+    }
+  });
+});

package/template/aliases.cjs

@@ -0,0 +1,16 @@
+module.exports = {
+  "@": "./src",
+  "@auth": "./src/modules/auth",
+  "@feature": "./src/modules/__MODULE__",
+  "@assets": "./src/assets",
+  "@common": "./src/common",
+  "@components": "./src/library/components",
+  "@env-config": "./env/env-config",
+  "@modules": "./src/modules",
+  "@navigation": "./src/navigation",
+  "@networking": "./src/library/networking",
+  "@redux": "./src/redux",
+  "@storage": "./src/library/utils/storage",
+  "@theme": "./src/themes",
+  "@utils": "./src/library/utils"
+};

package/template/app.config.js

@@ -0,0 +1,23 @@
+const fs = require('node:fs');
+const path = require('node:path');
+module.exports = ({ config }) => {
+  const selected = path.join(__dirname, 'env/selected.json');
+  const flavor =
+    process.env.APP_ENV ||
+    (fs.existsSync(selected)
+      ? JSON.parse(fs.readFileSync(selected, 'utf8')).flavor
+      : 'staging');
+  if (!['staging', 'beta', 'prod'].includes(flavor))
+    throw new Error('APP_ENV must be staging, beta or prod');
+  const input = JSON.parse(
+    fs.readFileSync(path.join(__dirname, 'env', `${flavor}.json`), 'utf8'),
+  );
+  const env = input.public || input;
+  return {
+    ...config,
+    plugins: [
+      ...(config.plugins || []),
+      ['react-native-app-auth', { redirectUrls: [env.AUTH.redirectUrl] }],
+    ],
+  };
+};

package/template/app.json

@@ -0,0 +1,17 @@
+{
+  "expo": {
+    "name": "__DISPLAY_NAME__",
+    "slug": "__PACKAGE_NAME__",
+    "version": "0.0.1",
+    "scheme": "__BUNDLE_ID__",
+    "ios": {
+      "bundleIdentifier": "__BUNDLE_ID__"
+    },
+    "android": {
+      "package": "__BUNDLE_ID__"
+    },
+    "plugins": [
+      "expo-dev-client"
+    ]
+  }
+}

package/template/babel.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+  presets: ['babel-preset-expo'],
+  plugins: [['module-resolver', {
+    extensions: ['.ios.ts', '.android.ts', '.ts', '.ios.tsx', '.android.tsx', '.tsx', '.ios.js', '.android.js', '.js', '.json'],
+    alias: require('./aliases.cjs'),
+  }], ['react-native-unistyles/plugin', { root: 'src' }], 'react-native-worklets/plugin'],
+};

package/template/declare/assets.d.ts

@@ -0,0 +1,11 @@
+declare module '*.svg' {
+  import type { FunctionComponent } from 'react';
+  import type { SvgProps } from 'react-native-svg';
+  const Component: FunctionComponent<SvgProps>;
+  export default Component;
+}
+declare module '*.png' {
+  import type { ImageSourcePropType } from 'react-native';
+  const source: ImageSourcePropType;
+  export default source;
+}

package/template/env/beta.json

@@ -0,0 +1,16 @@
+{
+  "ENV": "beta",
+  "BASE_URL": "https://api.beta.example.com",
+  "API_TIMEOUT_MS": 15000,
+  "AUTH": {
+    "issuer": "https://login.microsoftonline.com/YOUR_TENANT_ID/v2.0",
+    "clientId": "YOUR_CLIENT_ID",
+    "redirectUrl": "__BUNDLE_ID__.auth://oauth/redirect",
+    "scopes": [
+      "openid",
+      "profile",
+      "offline_access",
+      "api://YOUR_API_CLIENT_ID/access_as_user"
+    ]
+  }
+}

package/template/env/prod.json

@@ -0,0 +1,16 @@
+{
+  "ENV": "prod",
+  "BASE_URL": "https://api.prod.example.com",
+  "API_TIMEOUT_MS": 15000,
+  "AUTH": {
+    "issuer": "https://login.microsoftonline.com/YOUR_TENANT_ID/v2.0",
+    "clientId": "YOUR_CLIENT_ID",
+    "redirectUrl": "__BUNDLE_ID__.auth://oauth/redirect",
+    "scopes": [
+      "openid",
+      "profile",
+      "offline_access",
+      "api://YOUR_API_CLIENT_ID/access_as_user"
+    ]
+  }
+}

package/template/env/staging.json

@@ -0,0 +1,16 @@
+{
+  "ENV": "staging",
+  "BASE_URL": "https://api.staging.example.com",
+  "API_TIMEOUT_MS": 15000,
+  "AUTH": {
+    "issuer": "https://login.microsoftonline.com/YOUR_TENANT_ID/v2.0",
+    "clientId": "YOUR_CLIENT_ID",
+    "redirectUrl": "__BUNDLE_ID__.auth://oauth/redirect",
+    "scopes": [
+      "openid",
+      "profile",
+      "offline_access",
+      "api://YOUR_API_CLIENT_ID/access_as_user"
+    ]
+  }
+}

package/template/gitignore

@@ -0,0 +1,19 @@
+node_modules/
+.expo/
+build/
+coverage/
+*.tgz
+.DS_Store
+.env*
+env/env-config.ts
+env/selected.json
+# Commit package-lock.json after npm install.
+# Native projects are generated by npx expo prebuild; commit them if customizing native code.
+ios/Pods/
+ios/build/
+android/.gradle/
+android/app/build/
+android/build/
+android/local.properties
+*.keystore
+*.jks

package/template/index.js

@@ -0,0 +1,2 @@
+import 'react-native-gesture-handler';
+import './src/bootstrap';

package/template/index.repack.js

@@ -0,0 +1,14 @@
+import { Script, ScriptManager } from '@callstack/repack/client';
+
+if (__DEV__) {
+  ScriptManager.shared.addResolver(
+    async scriptId => ({
+      url: Script.getDevServerURL(scriptId),
+      cache: false,
+    }),
+    { key: '__APP_NAME__-dev-chunks', priority: 1 },
+  );
+}
+
+// Keep app/native modules behind the federation bootstrap boundary.
+import('./src/bootstrap');