@convep_mobilogy/react-native-qms-plugin 1.8.3 → 1.9.0

package/QmsPlugin.podspec

@@ -14,16 +14,14 @@ Pod::Spec.new do |s|
   s.homepage     = homepage
   s.license      = package["license"]
   s.authors      = package["author"]
-  s.platforms    = { :ios => "12.4" }
+  s.platforms    = { :ios => "15.1" }
 
   s.source       = { :git => "http://convep.ddns.me:20000/WeiHan/weihan-plugin.git", :tag => "#{s.version}" }
   s.source_files = "ios/QmsPlugin/**/*.{h,m,mm,cpp}", "ios/QmsPluginSpec/**/*.{h,mm}"
   s.private_header_files = "ios/QmsPlugin/**/*.h"
   s.public_header_files = "ios/QmsPluginSpec/**/*.h"
 
-  s.preserve_paths = "ios/QmsPluginFramework.xcframework"
-  s.vendored_frameworks = "ios/QmsPluginFramework.xcframework"
-
+  s.dependency "QmsPluginFramework", "1.31.0"
   s.dependency "React-Core"
   s.dependency "ReactCommon"
   s.dependency "React-Codegen"

package/QmsPluginFramework.podspec

@@ -0,0 +1,12 @@
+Pod::Spec.new do |s|
+  s.name = "QmsPluginFramework"
+  s.version = "1.31.0"
+  s.summary = "QMS Native iOS Framework"
+  s.description = "Native QMS iOS SDK distributed as XCFramework."
+  s.homepage = "https://sdk.convep.com"
+  s.license = { :type => "Proprietary", :text => "Copyright © Convep Mobilogy. All rights reserved." }
+  s.author = { "Convep Mobilogy" => "developer@convep.com" }
+  s.platform = :ios, "15.1"
+  s.source = { :http => "https://sdk.convep.com/ios/QMS/qms-plugin/1.31.0", :type => "zip", :sha256 => "6bae9da81e3b0df77a98edf939279290990539e954407dae90904b96192705cf" }
+  s.vendored_frameworks = "QmsPluginFramework.xcframework"
+end

package/README.md

@@ -2,6 +2,45 @@
 
 A React Native plugin that provides QMS (Quality Management System) components and APIs for defect management, dashboard visualization, and QMS workflow operations.
 
+## Development setup
+
+The development toolchain is managed with [mise](https://mise.jdx.dev/). From
+the repository root, install the pinned Node.js, Java, and Ruby versions and
+the JavaScript dependencies:
+
+```sh
+mise install
+mise run setup
+```
+
+The project pins Yarn through the `packageManager` field in `package.json`; the
+setup task enables Corepack before running the immutable Yarn install. Android
+SDK tooling and Xcode are platform dependencies and are not installed by mise.
+
+See [Contributing](CONTRIBUTING.md) for the complete development workflow and
+available mise tasks.
+
+To create a separate framework workspace with npm and local-development example
+apps, run:
+
+```sh
+./setup_framework.sh
+```
+
+The script confirms before moving this repository into a new
+`QmsPlugin_Framework` directory one level above its current location. See the
+contributing guide for the generated layout and non-interactive usage. It adds
+mise configuration to both generated apps and runs `mise install` plus
+`mise run setup` in the plugin and each app.
+
+For direct Kotlin/Java and Swift/Objective-C integration with the native AAR
+and XCFramework, see
+[Native QMS SDK Integration for Android and iOS](docs/ANDROID_IOS_INTEGRATION.md).
+
+For native Android development, AAR/Maven generation, example-app testing, and
+npm publishing, see
+[Android SDK Development and npm Release](docs/ANDROID_DEVELOPMENT_AND_RELEASE.md).
+
 ---
 
 # Installation
@@ -22,20 +61,132 @@ yarn add @convep_mobilogy/react-native-qms-plugin
 
 # iOS Setup
 
-Autolinking should set up everything automatically.
+Add the hosted native framework pod to the application `Podfile`. The podspec
+is shipped with the npm package and CocoaPods downloads the matching ZIP from
+`sdk.convep.com`:
+
+```ruby
+qms_plugin_package = Pod::Executable.execute_command('node', ['-p',
+  'require.resolve(
+    "@convep_mobilogy/react-native-qms-plugin/package.json",
+    {paths: [process.argv[1]]},
+  )', __dir__]).strip
+
+target 'YourApp' do
+  pod 'QmsPluginFramework',
+      :path => File.dirname(qms_plugin_package)
+end
+```
 
-1. Navigate to your iOS folder:
+Autolinking sets up the React Native wrapper. From the application's root
+directory, install all CocoaPods dependencies:
 
 ```sh
 cd ios
 pod install
 ```
 
+## iOS framework development
+
+Use the following workflow when changing the native iOS framework and testing
+it in the included example app.
+
+### 1. Open the framework project
+
+Open the following project in Xcode and make the required native changes:
+
+```text
+framework/ios_framework/QmsPluginFramework.xcodeproj
+```
+
+### 2. Build and publish the XCFramework
+
+From the plugin root, run the build helper. It archives the framework for both
+iOS devices and the iOS Simulator, creates the XCFramework, packages it, and
+uploads the versioned ZIP used by the native CocoaPod:
+
+```sh
+./compile_framework.sh ios
+```
+
+You can optionally provide the SDK version:
+
+```sh
+./compile_framework.sh ios <sdk-version>
+```
+
+The versioned XCFramework ZIP and its SHA-256 checksum are written to
+`framework/ios_framework/build/releases/<sdk-version>/`. The root
+`QmsPluginFramework.podspec` is updated for the release. The native pod has no
+React dependency. The command uploads the ZIP to
+`https://sdk.convep.com/api/uploadIOS` using the same credentials and upload
+fields as Android. See [the iOS release guide](docs/IOS_COCOAPODS_RELEASE.md)
+for upload settings and the client Podfile.
+
+To build the XCFramework manually instead, run the following commands:
+
+```sh
+cd framework/ios_framework
+rm -rf QmsPluginFramework.xcframework
+
+xcodebuild archive \
+  -project QmsPluginFramework.xcodeproj \
+  -scheme QmsPluginFramework \
+  -destination "generic/platform=iOS" \
+  -archivePath ./build/ios_devices.xcarchive \
+  SKIP_INSTALL=NO \
+  BUILD_LIBRARY_FOR_DISTRIBUTION=YES
+
+xcodebuild archive \
+  -project QmsPluginFramework.xcodeproj \
+  -scheme QmsPluginFramework \
+  -destination "generic/platform=iOS Simulator" \
+  -archivePath ./build/ios_simulators.xcarchive \
+  SKIP_INSTALL=NO \
+  BUILD_LIBRARY_FOR_DISTRIBUTION=YES
+
+xcodebuild -create-xcframework \
+  -framework ./build/ios_devices.xcarchive/Products/Library/Frameworks/QmsPluginFramework.framework \
+  -framework ./build/ios_simulators.xcarchive/Products/Library/Frameworks/QmsPluginFramework.framework \
+  -output ./QmsPluginFramework.xcframework
+```
+
+### 3. Install the example app's iOS dependencies
+
+From the plugin root, run this after the uploaded version is available so
+CocoaPods downloads the latest native build:
+
+```sh
+cd example/ios
+pod install
+```
+
+### 4. Start Metro
+
+In a separate terminal, start Metro from the plugin root:
+
+```sh
+cd example
+npx react-native start
+```
+
+### 5. Build and run the example app
+
+Open the CocoaPods workspace (not the `.xcodeproj`) and run the desired iOS
+Simulator or connected device:
+
+```text
+example/ios/QmsPluginExample.xcworkspace
+```
+
+Repeat steps 2 through 5 after each native framework change.
+
 ---
 
 # Android Setup
 
-Autolinking should set up everything automatically, but you need to add the private Maven repo and enable core library desugaring.
+Autolinking should set up everything automatically, but you need to add the QMS
+Maven repository and enable core library desugaring.
 
 1. In `android/build.gradle`, add the Maven repo:
 
@@ -47,7 +198,10 @@ allprojects {
         maven { url = uri("https://www.jitpack.io") }
 
         maven {
-            url = uri("https://raw.githubusercontent.com/ConvepMobilogy/QMS_framework/main/maven-repo")
+            url = uri("https://sdk.convep.com/maven")
+            content {
+                includeGroup("com.convep.qms")
+            }
         }
     }
 }
@@ -125,6 +279,31 @@ const styles = StyleSheet.create({
 
 ---
 
+## Open Add Issue Directly
+
+Use `QmsPlugin.openAddIssue` when the host app already knows the target unit and wants to skip the QMS project/unit/dashboard flow.
+
+```tsx
+import { QmsPlugin } from '@convep_mobilogy/react-native-qms-plugin';
+
+async function handleAddIssuePress() {
+  await QmsPlugin.openAddIssue({
+    userToken: '<UserToken>',
+    clientID: '<ClientID>',
+    clientCode: '<CompanyCode>',
+    isOrigin: false,
+    drawingPlanId: 1183,
+    projectId: 4,
+    unitName: 'C-L(7)',
+    projectName: 'Ara E Residence Dev',
+  });
+}
+```
+
+`drawingPlanId` is required because Add Issue needs a selected unit plan. `projectId`, `unitName`, and `projectName` are optional but recommended so the SDK can display and cache the correct context.
+
+---
+
 # Props
 
 ## QmsDashboardView Props

package/android/build.gradle

@@ -21,6 +21,16 @@ apply plugin: "kotlin-android"
 
 apply plugin: "com.facebook.react"
 
+def qmsLocalMavenRepo = uri("$projectDir/maven-repo")
+
+// Make the bundled native framework available to the consuming app. This lets
+// local TGZ installs use the matching AAR without waiting for remote publishing.
+rootProject.allprojects {
+  repositories {
+    maven { url = qmsLocalMavenRepo }
+  }
+}
+
 def getExtOrIntegerDefault(name) {
   return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["QmsPlugin_" + name]).toInteger()
 }
@@ -33,6 +43,7 @@ android {
   defaultConfig {
     minSdkVersion getExtOrIntegerDefault("minSdkVersion")
     targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+    consumerProguardFiles "consumer-rules.pro"
   }
 
   buildFeatures {
@@ -75,8 +86,7 @@ dependencies {
     implementation "com.facebook.react:react-android"
     implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
     implementation 'com.facebook.react:react-native:+' 
-    implementation "com.convep.qms:qms-plugin:1.25.2"
-
+    implementation "com.convep.qms:qms-plugin:1.31.0"
     implementation 'androidx.appcompat:appcompat:1.6.1'
 
     implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0'

package/android/consumer-rules.pro

@@ -0,0 +1,13 @@
+# React Native creates this package from the generated PackageList. Keep the
+# package and its native module entry points stable in minified host apps.
+-keep class com.qmsplugin.QmsPluginPackage { *; }
+-keep class com.qmsplugin.QmsPluginModule { *; }
+
+# The wrapper returns the native framework module to React Native. ReactMethod
+# methods are invoked through bridge metadata rather than ordinary Java calls.
+-keep class com.convep.qms.QmsModule { *; }
+-keepclassmembers class com.convep.qms.** {
+    @com.facebook.react.bridge.ReactMethod <methods>;
+}
+
+-keepattributes RuntimeVisibleAnnotations,RuntimeVisibleParameterAnnotations,AnnotationDefault

package/ios/QmsPlugin/QmsDashboardViewManager.mm

@@ -72,9 +72,12 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
 
 - (instancetype)initWithFrame:(CGRect)frame {
   if (self = [super initWithFrame:frame]) {
-    _dashboardVC = [QmsPluginUI makeViewController];   
+    // The controller must only be created after this native view is mounted.
+    // Creating it here lets credential props start the API flow before React
+    // has forwarded isOrigin, leaving a detached controller making requests.
+    _dashboardVC = nil;
     _didSetupVC = NO;
-    _dashboardVC.view.backgroundColor = [UIColor whiteColor];
+    _isOrigin = NO;
 
     // Listen for native dashboard close notification
     [[NSNotificationCenter defaultCenter] addObserver:self
@@ -114,6 +117,7 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
 
             // 1️⃣ create VC with props
             _dashboardVC = [QmsPluginUI makeViewController];
+            _dashboardVC.view.backgroundColor = [UIColor whiteColor];
 
             [parentVC addChildViewController:_dashboardVC];
             _dashboardVC.view.frame = parentVC.view.bounds;
@@ -177,8 +181,13 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
 }
 
 - (void)cleanupDashboard {
+    // APIConfig is process-global inside the framework. Reset it before
+    // teardown so a later embedded dashboard cannot inherit origin mode.
+    _isOrigin = NO;
     if (!_dashboardVC) return;
 
+    [self forwardProp:@"isOrigin" value:@NO];
+
     [_dashboardVC willMoveToParentViewController:nil];
     [_dashboardVC.view removeFromSuperview];
     [_dashboardVC removeFromParentViewController];
@@ -268,6 +277,9 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
 }
 
 - (void)forwardPropsToVC {
+    // Apply mode before credentials. The token setter can make the project
+    // controller ready and start its API chain immediately.
+    [self forwardProp:@"isOrigin" value:@(_isOrigin)];
     [self forwardProp:@"ClientID" value:_ClientID];
     [self forwardProp:@"ClientCode" value:_ClientCode];
     [self forwardProp:@"user_token" value:_user_token];
@@ -277,7 +289,6 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
     [self forwardProp:@"headerIconColor" value:_headerIconColor];
     [self forwardProp:@"accentColor" value:_accentColor];
     [self forwardProp:@"fontFamily" value:_fontFamily];
-    [self forwardProp:@"isOrigin" value:@(_isOrigin)];
     [self forwardProp:@"versionNumber" value:_versionNumber];
     [self applyAllThemeImmediatelyIfNeeded];
 }
@@ -299,7 +310,7 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
             @"new_issue", @"new_info", @"accept_issue", @"reject_issue", @"decline_issue",
             @"start_fix", @"redo", @"completed", @"close_internal", @"close_external",
             @"pending_owner_acceptance", @"assign_issue", @"reassign_issue", @"poa_reminder",
-            @"auto_close_reminder", @"pending_access_reminder", @"overdue_reminder",
+            @"auto_close_reminder", @"overdue_reminder",
             @"issue_summary_reminder", @"lodge_summary_reminder", @"overdue_summary_reminder"
         ]];
     });
@@ -311,8 +322,15 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
            [type isEqualToString:@"unattend_appt_reminder"];
 }
 
-- (BOOL)isDraftReminderType:(NSString *)type {
-    return [type isEqualToString:@"draft_reminder"];
+- (BOOL)isDashboardType:(NSString *)type {
+    static NSSet<NSString *> *types;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+        types = [NSSet setWithArray:@[
+           @"pending_access_reminder", @"completion_letter", @"key_collection", @"defect_summary", @"clearance_letter"
+        ]];
+    });
+    return type.length > 0 && [types containsObject:type];
 }
 
 - (void)applyPayloadContext:(NSDictionary *)payload {
@@ -429,23 +447,9 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
     UIViewController *presenter = self.dashboardVC;
     if (!presenter) return;
 
-    Class cls = NSClassFromString(@"DraftListingViewController");
-    if (!cls) {
-        NSLog(@"🧭 [DraftReminder] DraftListingViewController class not found");
-        return;
-    }
-
-    UIViewController *vc = [[cls alloc] init];
-    if (!vc) return;
-
-    // Pass project name if available so the listing filters to the right project
-    NSString *projectName = payload[@"project_name"];
-    if (projectName.length > 0) {
-        @try { [vc setValue:projectName forKey:@"projectName"]; }
-        @catch (__unused NSException *e) {}
-    }
-
-    [self presentDeepLinkVC:vc];
+    // Delegate to QmsPluginUI which handles account switching + presentation.
+    // AccountManager and DraftListingViewController are both inside the framework.
+    [QmsPluginUI presentDraftListingFromPayload:payload fromViewController:presenter];
 }
 
 - (void)routePayloadIfNeeded:(NSDictionary *)payload force:(BOOL)force {
@@ -485,13 +489,12 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
     } else if ([self isAppointmentType:type]) {
         NSLog(@"🧭 [QmsDashboardView] routing → presentAppointmentFromPayload (appointment type: %@)", type);
         [self presentAppointmentDetailsViewControllerWithPayload:payload title:title ?: @""];
-    } else if ([type isEqualToString:@"clearance_letter"]) {
-        NSLog(@"🧭 [QmsDashboardView] routing → presentDashboardFromPayload (clearance_letter)");
+    } else if ([self isDashboardType:type]) {
+        NSLog(@"🧭 [QmsDashboardView] routing → presentDashboardFromPayload (dashboard type: %@)", type);
         [self presentDashboardViewControllerWithPayload:payload title:title ?: @""];
-    } else if ([self isDraftReminderType:type]) {
+    } else if ([type isEqualToString:@"draft_reminder"]) {
         NSLog(@"🧭 [QmsDashboardView] routing → presentDraftListingViewController (draft_reminder)");
-        // [self presentDraftListingViewControllerWithPayload:payload];
-        [self presentDashboardViewControllerWithPayload:payload title:title ?: @""];
+        [self presentDraftListingViewControllerWithPayload:payload];
     } else {
         NSLog(@"🧭 [QmsDashboardView] routePayloadIfNeeded — no route matched for type=%@", type ?: @"(none)");
     }
@@ -544,6 +547,12 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
 - (void)applyHeaderThemeRecursivelyOnView:(UIView *)view textColor:(UIColor *)textColor iconColor:(UIColor *)iconColor {
     if (!view) return;
 
+    // Skip views tagged 9001 and their entire subtree — they manage their own colour.
+    if (view.tag == 9001) return;
+
+    // Never reach into UISegmentedControl internals.
+    if ([view isKindOfClass:[UISegmentedControl class]]) return;
+
     if (textColor && [view isKindOfClass:[UILabel class]]) {
         UILabel *label = (UILabel *)view;
         CGPoint originInRoot = [label.superview convertPoint:label.frame.origin toView:_dashboardVC.view];
@@ -588,6 +597,13 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
 - (void)applyThemeRecursivelyOnView:(UIView *)view color:(UIColor *)themeColor {
     if (!view || !themeColor) return;
 
+    // Skip views tagged 9001 and their entire subtree — they manage their own colour.
+    if (view.tag == 9001) return;
+
+    // Never reach into UISegmentedControl internals — its tint/selected colour
+    // is set directly via selectedSegmentTintColor and must not be overwritten here.
+    if ([view isKindOfClass:[UISegmentedControl class]]) return;
+
     CGPoint originInRoot = [view.superview convertPoint:view.frame.origin toView:_dashboardVC.view];
     BOOL nearHeader = originInRoot.y <= 140.0 && view.bounds.size.height <= 120.0;
     if (nearHeader && [self isDefaultQmsBlueColor:view.backgroundColor]) {
@@ -644,6 +660,16 @@ static NSString * const kQmsRoutePayloadNotification = @"QmsRoutePayloadNotifica
 - (void)applyAccentRecursivelyOnView:(UIView *)view color:(UIColor *)color {
     if (!view || !color) return;
 
+    // Skip views (and their entire subtree) that have been tagged 9001 —
+    // this lets individual controls opt-out of theme colour replacement.
+    if (view.tag == 9001) return;
+
+    if ([view isKindOfClass:[UISegmentedControl class]]) {
+        // Never touch the internals of a UISegmentedControl — its
+        // selectedSegmentTintColor is managed by the VC that owns it.
+        return;
+    }
+
     if ([view isKindOfClass:[UIButton class]]) {
         UIButton *button = (UIButton *)view;
         button.tintColor = color;
@@ -798,7 +824,10 @@ RCT_EXPORT_MODULE();
         @"onAnalyticsScreen",
         @"onAnalyticsEvent",
         @"QmsSdkOnAnalyticsScreen",
-        @"QmsSdkOnAnalyticsEvent"
+        @"QmsSdkOnAnalyticsEvent",
+        @"onDraftIssueCreated",
+        @"onDraftIssueDeleted",
+        @"onPoaSignOffCompleted"
     ];
 }
 
@@ -826,6 +855,18 @@ RCT_EXPORT_MODULE();
                selector:@selector(handleActiveAccountChangeEmitter:)
                    name:@"QmsActiveAccountDidChangeNotification"
                  object:nil];
+    [center addObserver:self
+               selector:@selector(handleDraftIssueCreated:)
+                   name:@"QmsDraftIssueCreatedNotification"
+                 object:nil];
+    [center addObserver:self
+               selector:@selector(handleDraftIssueDeleted:)
+                   name:@"QmsDraftIssueDeletedNotification"
+                 object:nil];
+    [center addObserver:self
+               selector:@selector(handlePoaSignOffCompleted:)
+                   name:@"QmsPoaSignOffCompleted"
+                 object:nil];
 }
 
 - (void)stopObserving {
@@ -855,6 +896,18 @@ RCT_EXPORT_MODULE();
     [self sendEventWithName:@"onActiveAccountChange" body:note.userInfo];
 }
 
+- (void)handleDraftIssueCreated:(NSNotification *)note {
+    [self sendEventWithName:@"onDraftIssueCreated" body:note.userInfo];
+}
+
+- (void)handleDraftIssueDeleted:(NSNotification *)note {
+    [self sendEventWithName:@"onDraftIssueDeleted" body:note.userInfo];
+}
+
+- (void)handlePoaSignOffCompleted:(NSNotification *)note {
+    [self sendEventWithName:@"onPoaSignOffCompleted" body:note.userInfo ?: @{}];
+}
+
 - (void)dealloc {
     [self stopObserving];
 }