chore: added POC pos project (#313)

Author: ignaciosantise

dapps/poc-pos-app/.env.example

@@ -0,0 +1,6 @@
+EXPO_PUBLIC_PROJECT_ID=""
+EXPO_PUBLIC_SENTRY_DSN=""
+SENTRY_AUTH_TOKEN=""
+EXPO_PUBLIC_API_URL=""
+EXPO_PUBLIC_GATEWAY_URL=""
+EXPO_PUBLIC_MERCHANTS_URL=""

dapps/poc-pos-app/.gitignore

@@ -0,0 +1,48 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+# Skia Web artifacts
+public/
+web/
+
+app-example
+
+.env.local
+
+ios/*
+android/*

dapps/poc-pos-app/README.md

@@ -0,0 +1,179 @@
+# Welcome to POC POS Sample app
+
+> ⚠️ **WARNING: This is legacy code and is no longer actively maintained.** Use at your own risk.
+
+## Prerequisites
+
+Before you begin, make sure you have set up your React Native development environment. This includes installing Node, Android Studio (for Android), and Xcode (for iOS on macOS).
+
+Follow the official React Native documentation to set up your environment:
+- [React Native Environment Setup](https://reactnative.dev/docs/set-up-your-environment?platform=android)
+
+## Get started
+
+1. Install dependencies
+
+   ```bash
+   npm install
+   ```
+
+2. Set up environment variables
+
+   Create a `.env` file using the example template:
+
+   ```bash
+   cp .env.example .env
+   ```
+
+   Update the `.env` file with your configuration values.
+
+3. Create native folders
+
+   ```bash
+   npm run prebuild
+   ```
+
+   This will automatically set up the required files for development.
+
+4. Start the app
+
+   ```bash
+   npm run android
+   ```
+
+   ```bash
+   npm run ios
+   ```
+
+   ```bash
+   npm run web
+   ```
+
+## Production Releases
+
+For production Android releases, you'll need the actual `secrets.properties` file and `wc_rn_upload.keystore`. Get these from the mobile team or 1Password.
+
+**Required file locations:**
+- Place `secrets.properties` in the `android/` directory
+- Place `wc_rn_upload.keystore` in the `android/app/` directory
+
+```
+android/
+├── secrets.properties          ← Place here
+└── app/
+    └── wc_rn_upload.keystore  ← Place here
+```
+
+**Build the release APK:**
+
+```bash
+npm run android:build
+```
+
+The release APK will be generated at `android/app/build/outputs/apk/release/app-release.apk`
+
+**Install on a device via USB:**
+
+> **Note**: Make sure USB debugging is enabled on your Android device. Go to Settings → About phone → Tap "Build number" 7 times → Developer options → Enable "USB debugging".
+
+1. Connect your device via USB and get its device ID:
+
+   ```bash
+   adb devices
+   ```
+   
+   Example output: `V510BAC07114B000171`
+
+2. Build the release APK:
+
+   ```bash
+   npm run android:build
+   ```
+
+3. Install the APK on your device (replace with your device ID):
+
+   ```bash
+   adb -s V510BAC07114B000171 install android/app/build/outputs/apk/release/app-release.apk
+   ```
+
+> **⚠️ Security Note**: Never commit `secrets.properties` or keystore files to version control.
+
+## Creating Custom Variants
+
+To create a branded variant for a specific client:
+
+1. **Create a new branch**
+   ```bash
+   git checkout -b variant/<client-name>
+   ```
+
+2. **Add the variant logo**
+   - Add the client's logo to `assets/images/variants/<client-name>_brand.png`
+   - **Requirements**: PNG format
+
+3. **Add the printer logo** in `constants/printer-logos.ts`
+   - Convert the client's logo to base64 using https://base64.guru/converter/encode/image/png
+   - Add the base64 string as a new constant:
+     ```typescript
+     export const <CLIENT_NAME>_LOGO_BASE64 =
+       "data:image/png;base64,<base64-string>";
+     ```
+
+4. **Define the variant** in `constants/variants.ts`
+   - Import the printer logo at the top of the file:
+     ```typescript
+     import {
+       // ... existing imports ...
+       <CLIENT_NAME>_LOGO_BASE64,
+     } from "./printer-logos";
+     ```
+   - Add the variant name to the `VariantName` type:
+     ```typescript
+     export type VariantName =
+       | "default"
+       | "solflare"
+       | "binance"
+       | "phantom"
+       | "solana"
+       | "<client-name>";
+     ```
+   - Add the variant configuration to the `Variants` object:
+     ```typescript
+     <client-name>: {
+       name: "<Client Name>",
+       brandLogo: require("@/assets/images/variants/<client-name>_brand.png"),
+       printerLogo: <CLIENT_NAME>_LOGO_BASE64,
+       defaultTheme: "light", // or "dark"
+       colors: {
+         light: {
+           "icon-accent-primary": "#HEXCOLOR",
+           "bg-accent-primary": "#HEXCOLOR",
+           "bg-payment-success": "#HEXCOLOR",
+           "text-payment-success": "#HEXCOLOR",
+           "border-payment-success": "#HEXCOLOR",
+         },
+         dark: {
+           // Same color keys as light theme
+         },
+       },
+     },
+     ```
+
+
+5. **Update Android version code** in `app.json`
+   - Increment `expo.android.versionCode`
+
+6. **Commit, push, and create a release tag (Devin only)**
+   ```bash
+   git add .
+   git commit -m "feat: add <client-name> variant"
+   git push origin variant/<client-name>
+   git tag variant-<client-name>
+   git push origin variant-<client-name>
+   ```
+   The tag will trigger the release workflow automatically.
+
+7. **Verify the release**
+   - Check the build status and Firebase link in the `#system-releases-react-native` Slack channel
+
+**Manual release**: If you need to trigger the release manually instead of using a tag, go to GitHub Actions and run the `release-pos-poc` workflow.

dapps/poc-pos-app/api/client.ts

@@ -0,0 +1,140 @@
+import { useLogsStore } from "@/store/useLogsStore";
+import { ApiError } from "@/utils/types";
+
+const API_BASE_URL = process.env.EXPO_PUBLIC_API_URL;
+if (!API_BASE_URL) {
+  throw new Error("EXPO_PUBLIC_API_URL environment variable is not configured");
+}
+
+const MERCHANT_API_BASE_URL = process.env.EXPO_PUBLIC_MERCHANTS_URL;
+if (!MERCHANT_API_BASE_URL) {
+  throw new Error(
+    "EXPO_PUBLIC_MERCHANTS_URL environment variable is not configured",
+  );
+}
+
+interface RequestOptions extends Omit<RequestInit, "body"> {
+  body?: unknown;
+}
+
+class ApiClient {
+  private baseUrl: string;
+
+  constructor(baseUrl: string) {
+    this.baseUrl = baseUrl;
+  }
+
+  private async request<T>(
+    endpoint: string,
+    options: RequestOptions = {},
+  ): Promise<T> {
+    const { body, headers, ...fetchOptions } = options;
+
+    // Normalize URL construction: remove trailing slash from baseUrl and ensure endpoint starts with /
+    const normalizedBaseUrl = this.baseUrl.replace(/\/+$/, "");
+    const normalizedEndpoint = endpoint.startsWith("/")
+      ? endpoint
+      : `/${endpoint}`;
+    const url = `${normalizedBaseUrl}${normalizedEndpoint}`;
+
+    const requestHeaders: HeadersInit = {
+      "Content-Type": "application/json",
+      ...headers,
+    };
+
+    const config: RequestInit = {
+      ...fetchOptions,
+      headers: requestHeaders,
+    };
+
+    if (body) {
+      config.body = JSON.stringify(body);
+    }
+
+    try {
+      const response = await fetch(url, config);
+
+      if (!response.ok) {
+        const errorData = await this.parseErrorResponse(response);
+        const error: ApiError = {
+          message:
+            errorData.message || `HTTP error! status: ${response.status}`,
+          code: errorData.code,
+          status: response.status,
+        };
+        throw error;
+      }
+
+      const data = await response.json();
+      useLogsStore
+        .getState()
+        .addLog("info", "API request successful", "api", "request", {
+          endpoint,
+          body,
+          response: data,
+        });
+      return data as T;
+    } catch (error) {
+      if (error && typeof error === "object" && "status" in error) {
+        const apiError = error as ApiError;
+        useLogsStore
+          .getState()
+          .addLog(
+            "error",
+            apiError.message || "API request failed",
+            "api",
+            "request",
+            { endpoint, body, response: error },
+          );
+        throw error;
+      }
+      const errorMessage =
+        error instanceof Error ? error.message : "An unexpected error occurred";
+      useLogsStore
+        .getState()
+        .addLog("error", errorMessage, "api", "request", { endpoint });
+      const apiError: ApiError = {
+        message: errorMessage,
+      };
+      throw apiError;
+    }
+  }
+
+  private async parseErrorResponse(
+    response: Response,
+  ): Promise<{ message?: string; code?: string }> {
+    try {
+      return await response.json();
+    } catch {
+      return { message: response.statusText };
+    }
+  }
+
+  async get<T>(endpoint: string, options?: RequestOptions): Promise<T> {
+    return this.request<T>(endpoint, { ...options, method: "GET" });
+  }
+
+  async post<T>(
+    endpoint: string,
+    body?: unknown,
+    options?: RequestOptions,
+  ): Promise<T> {
+    return this.request<T>(endpoint, { ...options, method: "POST", body });
+  }
+
+  async put<T>(
+    endpoint: string,
+    body?: unknown,
+    options?: RequestOptions,
+  ): Promise<T> {
+    return this.request<T>(endpoint, { ...options, method: "PUT", body });
+  }
+
+  async delete<T>(endpoint: string, options?: RequestOptions): Promise<T> {
+    return this.request<T>(endpoint, { ...options, method: "DELETE" });
+  }
+}
+
+export const apiClient = new ApiClient(API_BASE_URL);
+
+export const merchantClient = new ApiClient(MERCHANT_API_BASE_URL);