ionic-vhframeworks 10.8.1 → 10.8.3

package/lib/ionic-vhframeworks.service.d.ts

@@ -27,6 +27,7 @@ import { BluetoothSerial } from '@ionic-native/bluetooth-serial/ngx';
 import { TranslateLoader, TranslateService } from '@ngx-translate/core';
 import { HttpClient } from '@angular/common/http';
 import { MyUploadImageAdapter } from "./my-class";
+import "cordova-plugin-purchase";
 import * as i0 from "@angular/core";
 export declare class VhIDB {
     private db;
@@ -170,6 +171,155 @@ export declare class VhEventMediator {
     static ɵfac: i0.ɵɵFactoryDeclaration<VhEventMediator, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<VhEventMediator>;
 }
+/**
+ * 🧩 Iap2Service
+ * -------------------------
+ * Service quản lý toàn bộ luồng In-App Purchase (IAP)
+ * Sử dụng plugin: `cordova-plugin-purchase`
+ *
+ * 👉 Hỗ trợ cả:
+ *    - Android (Google Play)
+ *    - iOS (App Store)
+ *
+ * Các nhiệm vụ chính:
+ *   - Khởi tạo store
+ *   - Đăng ký danh sách sản phẩm
+ *   - Theo dõi sự kiện mua hàng
+ *   - Xử lý các trạng thái giao dịch (approved, verified, expired, ...)
+ *   - Cho phép refresh / restore / purchase thủ công
+ */
+/*************************** CÁCH DÙNG FW Iap2Service *******************************************
+import { Component, OnInit, OnDestroy } from '@angular/core';
+import { Iap2Service } from '../services/iap2.service';
+import { Subscription } from 'rxjs';
+
+@Component({
+  selector: 'app-home',
+  templateUrl: 'home.page.html',
+  styleUrls: ['home.page.scss'],
+})
+export class HomePage implements OnInit, OnDestroy {
+  private PRODUCT_IDS: string[] = [
+    "inapp_xprinterpos_main_standard_1day,
+    "inapp_xprinterpos_main_standard_1month",
+    "inapp_xprinterpos_main_standard_12month",
+    "inapp_xprinterpos_main_pro_1month",
+    "inapp_xprinterpos_main_pro_12month",
+    "inapp_xprinterpos_main_super_pro_1month",
+    "inapp_xprinterpos_main_super_pro_12month",
+  ];
+  products: Array<{ id: string; title: string; desc: string; price: string; saveTag?: string }> = [];
+  selectedPlanIndex: number = 0;
+  private productsSub?: Subscription;
+
+  constructor(private iap2Service: Iap2Service) {}
+
+  ngOnInit(): void {
+    this.iap2Service.initPurchase(this.PRODUCT_IDS);
+    this.productsSub = this.iap2Service.products$.subscribe((tmp: any[]) => {
+      this.products = (tmp || []).map((item: any) => {
+        let price: string = '';
+        if (Array.isArray(item.offers) && item.offers.length > 0 && Array.isArray(item.offers[0].pricingPhases) && item.offers[0].pricingPhases.length > 0) {
+          price = item.offers[0].pricingPhases[0].price;
+        }
+        return {
+          id: item.id as string,
+          title: item.title as string,
+          desc: item.description as string,
+          price: price,
+        };
+      });
+    });
+  }
+
+  ngOnDestroy(): void {
+    this.productsSub?.unsubscribe();
+  }
+
+  selectPlan(i: number): void {
+    this.selectedPlanIndex = i;
+  }
+
+  purchaseSelectedPlan(): void {
+    const selectedProduct = this.products[this.selectedPlanIndex];
+    if (selectedProduct) {
+      console.log("==> product id", selectedProduct.id);
+      this.iap2Service.purchase(selectedProduct.id, 'oIpCK6jgMxLHOPrwV1Sm');
+    }
+  }
+}
+ */
+export declare class Iap2Service {
+    private platform;
+    private vhMGDB_auth;
+    /**
+     * 🔸 Danh sách ID sản phẩm trên Store (Google / Apple)
+     *
+     * 👉 Các ID này phải trùng với phần bạn cấu hình trên Google Play Console hoặc App Store Connect.
+     * 👉 Nếu sai, store sẽ không nhận diện được sản phẩm.
+     */
+    private PRODUCT_IDS;
+    private app_product;
+    private id_branch;
+    /**
+     * 🔹 Biến lưu instance store (được plugin quản lý)
+     * - Là trung tâm quản lý mọi giao dịch mua hàng
+     */
+    private store?;
+    /** Observable phát danh sách sản phẩm đã load */
+    private productsSubject;
+    products$: Observable<any[]>;
+    constructor(platform: Platform, vhMGDB_auth: VhMGDB_auth);
+    /**
+     * 🚀 Khởi tạo hệ thống In-App Purchase
+     * -----------------------------------
+     * Thực hiện tuần tự:
+     * 1️⃣ Chờ thiết bị sẵn sàng (Platform Ready)
+     * 2️⃣ Lấy instance `CdvPurchase.store`
+     * 3️⃣ Xác định nền tảng (Android hoặc iOS)
+     * 4️⃣ Đăng ký sản phẩm vào store
+     * 5️⃣ Gắn các event handler xử lý giao dịch
+     * 6️⃣ Khởi tạo và làm mới store
+     * 7️⃣ Chờ store sẵn sàng hoàn toàn (store.ready())
+     *  PRODUCT_IDS: string[] = [
+          "store_main_package_standard_1month",
+          "store_main_package_standard_12month",
+          "store_main_package_standard_24month",
+          "store_main_package_standard_60month",
+        ];
+     */
+    initPurchase(PRODUCT_IDS: any): void;
+    /**
+     * 🧠 Gắn các event handler xử lý luồng mua hàng
+     * ---------------------------------------------
+     * Mỗi bước của giao dịch (approved, verified, refunded, expired, rejected, error)
+     * đều được log ra console để dev theo dõi và xử lý nghiệp vụ phía backend nếu cần.
+     */
+    private registerHandlersForPurchase;
+    /**
+     * Thực hiện mua sản phẩm
+     * @param app_product - sản phẩm trên chplay, appstore cần mua
+     */
+    purchase(app_product: any, id_branch: string): void;
+    /**
+     * Refresh thông tin sản phẩm từ store
+     * Cập nhật giá cả và thông tin sản phẩm mới nhất
+     */
+    refreshPurchase(): void;
+    /**
+     * Lấy danh sách các sản phẩm đã được đăng ký
+     * @returns Mảng các sản phẩm đã được load thành công
+     */
+    getRegisteredProducts(): any[];
+    /**
+     * Khôi phục các giao dịch đã mua trước đó
+     * Hữu ích khi user cài đặt lại app hoặc chuyển thiết bị
+     */
+    restorePurchase(): void;
+    private create_Payment_Apple_Google_Pay;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Iap2Service, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<Iap2Service>;
+}
 export declare class VhAlgorithm {
     private platform;
     private file;
@@ -6518,7 +6668,21 @@ export declare class VhQueryCafe {
     */
     getLicenseKEYs(query: any, projection?: object, sort?: object, limit?: number): Promise<unknown>;
     /**
-     * Tạo mã QR cho Shop quét thanh toán
+   * Lấy về danh sách các ngân hàng (kèm logo) mà vietqr hỗ trợ tạo mã QR
+   * @example:
+   * this.vhQueryCafe.vietqr_getBanks()
+          .then((rsp:any)=>{
+            if(rsp.vcode === 0){
+            }
+          }, error=>{
+            console.log(error)
+          })
+    * @returns Promise => rsp ={vcode, msg, data(array)} / error
+    * vcode == 0: success
+    */
+    vietqr_getBanks(): Promise<unknown>;
+    /**
+     * Tạo mã QR cho Shop quét thanh toán vào tài khoản ngân hàng đã đăng ký Casso
      * @example:
      * this.vhQueryCafe.vietqr_generateQR('0909925354', 'LE DUC HUY', '970422', 'compact2', '674fd94a9ace7267deb685fd', 99000)
             .then((rsp:any)=>{
@@ -17488,7 +17652,21 @@ export declare class VhQuerySales {
     */
     getLicenseKEYs(query: any, projection?: object, sort?: object, limit?: number): Promise<unknown>;
     /**
-     * Tạo mã QR cho Shop quét thanh toán
+   * Lấy về danh sách các ngân hàng (kèm logo) mà vietqr hỗ trợ tạo mã QR
+   * @example:
+   * this.vhQuerySales.vietqr_getBanks()
+          .then((rsp:any)=>{
+            if(rsp.vcode === 0){
+            }
+          }, error=>{
+            console.log(error)
+          })
+    * @returns Promise => rsp ={vcode, msg, data(array)} / error
+    * vcode == 0: success
+    */
+    vietqr_getBanks(): Promise<unknown>;
+    /**
+     * Tạo mã QR cho Shop quét thanh toán vào tài khoản ngân hàng đã đăng ký Casso
      * @example:
      * this.vhQuerySales.vietqr_generateQR('0909925354', 'LE DUC HUY', '970422', 'compact2', '674fd94a9ace7267deb685fd', 99000)
             .then((rsp:any)=>{
@@ -20646,7 +20824,7 @@ export declare class VhQueryDealer {
      */
     vietqr_getBanks(): Promise<unknown>;
     /**
-     * Tạo mã QR cho Đại lý quét thanh toán
+     * Tạo mã QR cho Shop quét thanh toán vào tài khoản ngân hàng đã đăng ký Casso
      * @example:
      * this.vhQueryDealer.vietqr_generateQR('0909925354', 'LE DUC HUY', '970422', 'compact2', '674fd94a9ace7267deb685fd', 99000)
             .then((rsp:any)=>{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ionic-vhframeworks",
-  "version": "10.8.1",
+  "version": "10.8.3",
   "peerDependencies": {
     "@angular/common": "^12.2.0",
     "@angular/core": "^12.2.0"