@vetc-miniapp/apis 0.0.1

package/README.md

@@ -0,0 +1,25 @@
+# MiniApp JS SDK
+
+SDK giúp Mini App giao tiếp với Super App host thông qua JS Bridge.
+
+## Cài đặt
+
+```bash
+npm install @yourcompany/miniapp-sdk
+```
+## Sử dụng
+
+import MiniApp from "@vetc/miniapp-sdk";
+
+MiniApp.getScopedToken().then(console.log);
+
+MiniApp.pickImage({ source: "camera" }).then(console.log);
+
+MiniApp.on("TOKEN_REFRESH", data => {
+  console.log("Token updated:", data);
+});
+
+npm run build
+npm publish --access public
+
+

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@vetc-miniapp/apis",
+  "version": "0.0.1",
+  "description": "MiniApp Platform JS SDK",
+  "main": "src/apis/index.js",
+  "type": "module",
+  "types": "src/apis/index.d.ts",
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "build": "webpack"
+  },
+  "keywords": [
+    "miniapp",
+    "superapp",
+    "bridge",
+    "sdk"
+  ],
+  "author": "Hieuth052@gmail.com",
+  "license": "MIT",
+  "devDependencies": {
+    "@babel/core": "^7.29.0",
+    "@babel/preset-env": "^7.29.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "babel-loader": "^10.0.0",
+    "rollup": "^4.57.1",
+    "webpack-cli": "^6.0.1"
+  }
+}

package/src/apis/common/index.d.ts

@@ -0,0 +1,9 @@
+export interface IVETCMiniAppResponse<T = any> {
+  ok: boolean;
+  data?: T;
+  error?: string;
+  message?: string;
+}
+export type IVETCPlatform = 'ios' | 'android' | 'macos' | 'windows' | 'web' | 'native' | ({} & string);
+export type IVETCSystem = 'Android' | 'iOS' | 'iPhone OS' | 'iPadOS' | ({} & string);
+export type IVETCLocale = 'en' | 'vi' | ({} & string);

package/src/apis/index.d.ts

@@ -0,0 +1,107 @@
+export interface IVETCMiniAppResponse<T = any> {
+  ok: boolean;
+  data?: T;
+  error?: string;
+  message?: string;
+}
+
+/* ================= Permissions ================= */
+
+export type MiniAppPermission =
+  | "location"
+  | "camera"
+  | "microphone"
+  | "photos"
+  | "contacts"
+  | "bluetooth"
+  | "nfc";
+
+/* ================= Core Payloads ================= */
+
+export interface NavigateParams {
+  title?: string;
+  [key: string]: any;
+
+}
+
+/* ================= Main SDK ================= */
+
+export interface MiniAppSDK {
+  confirmBeforeExit(
+    title?: string,
+    message?: string,
+    success?: Function,
+    fail?: Function,
+    complete?: Function
+  ): Promise<IVETCMiniAppResponse>;
+
+  exitMiniApp(
+    success?: Function,
+    fail?: Function,
+    complete?: Function
+  ): Promise<IVETCMiniAppResponse>;
+
+  openAppSetting(
+    success?: Function,
+    fail?: Function,
+    complete?: Function
+  ): Promise<IVETCMiniAppResponse>;
+
+  openNativeAppStore(
+    appleStoreId?: string,
+    googlePlayId?: string,
+    success?: Function,
+    fail?: Function,
+    complete?: Function
+  ): Promise<IVETCMiniAppResponse>;
+
+  shareApp(
+    title?: string,
+    description?: string,
+    path?: string,
+    url?: string,
+    success?: Function,
+    fail?: Function,
+    complete?: Function
+  ): Promise<IVETCMiniAppResponse>;
+
+  getAuthCode(
+    scopes?: string[],
+    success?: Function,
+    fail?: Function,
+    complete?: Function
+  ): Promise<IVETCMiniAppResponse<{ code: string }>>;
+
+  getUserInfo(
+    success?: Function,
+    fail?: Function,
+    complete?: Function
+  ): Promise<IVETCMiniAppResponse<Record<string, any>>>;
+
+  navigate(
+    screen: string,
+    params?: NavigateParams
+  ): Promise<IVETCMiniAppResponse>;
+
+  close(result?: any): Promise<IVETCMiniAppResponse>;
+
+  requestPermission(
+    permission: MiniAppPermission,
+    reason?: string
+  ): Promise<IVETCMiniAppResponse>;
+
+  requestLocation(reason?: string): Promise<IVETCMiniAppResponse>;
+  requestCamera(reason?: string): Promise<IVETCMiniAppResponse>;
+  requestMicrophone(reason?: string): Promise<IVETCMiniAppResponse>;
+  requestPhotos(reason?: string): Promise<IVETCMiniAppResponse>;
+  requestContacts(reason?: string): Promise<IVETCMiniAppResponse>;
+  requestBluetooth(reason?: string): Promise<IVETCMiniAppResponse>;
+  requestNFC(reason?: string): Promise<IVETCMiniAppResponse>;
+
+  on(event: string, callback: (data: any) => void): void;
+}
+
+/* Default export */
+declare const MiniApp: MiniAppSDK;
+export default MiniApp;
+export { MiniApp };

package/src/apis/index.js

@@ -0,0 +1,75 @@
+const isBrowser = typeof window !== "undefined";
+
+const getBridge = () => {
+  if (!isBrowser || !window.flutter_inappwebview) {
+    return null;
+  }
+  return window.flutter_inappwebview;
+};
+
+const callHost = (action, payload = {}) => {
+  const bridge = getBridge();
+  if (!bridge) {
+    return Promise.reject(new Error("MiniApp bridge not available"));
+  }
+  return bridge.callHandler("MiniAppBridge", { action, payload });
+};
+
+export const MiniApp = {
+  confirmBeforeExit(title, message, success, fail, complete) {
+    return callHost("confirmBeforeExit", { title, message, success, fail, complete });
+  },
+  exitMiniApp(success, fail, complete) {
+    return callHost("exitMiniApp", { success, fail, complete });
+  },
+  openAppSetting(success, fail, complete) {
+    return callHost("openAppSetting", { success, fail, complete });
+  },
+  openNativeAppStore(appleStoreId, googlePlayId, success, fail, complete) {
+    return callHost("openNativeAppStore", { appleStoreId, googlePlayId, success, fail, complete });
+  },
+  shareApp(title, description, path, url, success, fail, complete) {
+    return callHost("shareApp", { title, description, path, url, success, fail, complete });
+  },
+  getAuthCode(scopes, success, fail, complete) {
+    return callHost("getAuthCode", { scopes, success, fail, complete });
+  },
+  getUserInfo(success, fail, complete) {
+    return callHost("getUserInfo", { success, fail, complete });
+  },
+  navigate(screen, params = {}) {
+    return callHost("navigate", { type: "native", screen, params });
+  },
+  close(result = {}) {
+    return callHost("close", { result });
+  },
+  requestPermission(permission, reason) {
+    return callHost("requestPermission", { permission, reason });
+  },
+  requestLocation(reason) { return MiniApp.requestPermission("location", reason); },
+  requestCamera(reason) { return MiniApp.requestPermission("camera", reason); },
+  requestMicrophone(reason) { return MiniApp.requestPermission("microphone", reason); },
+  requestPhotos(reason) { return MiniApp.requestPermission("photos", reason); },
+  requestContacts(reason) { return MiniApp.requestPermission("contacts", reason); },
+  requestBluetooth(reason) { return MiniApp.requestPermission("bluetooth", reason); },
+  requestNFC(reason) { return MiniApp.requestPermission("nfc", reason); },
+
+  _listeners: {},
+  on(event, callback) {
+    if (!MiniApp._listeners[event]) MiniApp._listeners[event] = [];
+    MiniApp._listeners[event].push(callback);
+  },
+  _emit(event, data) {
+    (MiniApp._listeners[event] || []).forEach((cb) => cb(data));
+  },
+};
+
+// Gắn listener CHỈ khi có window
+if (isBrowser) {
+  window.addEventListener("miniapp_event", (e) => {
+    const { type, data } = e.detail || {};
+    MiniApp._emit(type, data);
+  });
+}
+
+export default MiniApp;

package/src/dist/apis/index.js

@@ -0,0 +1 @@
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports.MiniApp=t():e.MiniApp=t()}(this,()=>(()=>{"use strict";var e={d:(t,o)=>{for(var s in o)e.o(o,s)&&!e.o(t,s)&&Object.defineProperty(t,s,{enumerable:!0,get:o[s]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{MiniApp:()=>i,default:()=>r});const o="undefined"!=typeof window,s=(e,t={})=>{const s=o&&window.flutter_inappwebview?window.flutter_inappwebview:null;return s?s.callHandler("MiniAppBridge",{action:e,payload:t}):Promise.reject(new Error("MiniApp bridge not available"))},i={confirmBeforeExit:(e,t,o,i,r)=>s("confirmBeforeExit",{title:e,message:t,success:o,fail:i,complete:r}),exitMiniApp:(e,t,o)=>s("exitMiniApp",{success:e,fail:t,complete:o}),openAppSetting:(e,t,o)=>s("openAppSetting",{success:e,fail:t,complete:o}),openNativeAppStore:(e,t,o,i,r)=>s("openNativeAppStore",{appleStoreId:e,googlePlayId:t,success:o,fail:i,complete:r}),shareApp:(e,t,o,i,r,n,p)=>s("shareApp",{title:e,description:t,path:o,url:i,success:r,fail:n,complete:p}),getAuthCode:(e,t,o,i)=>s("getAuthCode",{scopes:e,success:t,fail:o,complete:i}),getUserInfo:(e,t,o)=>s("getUserInfo",{success:e,fail:t,complete:o}),navigate:(e,t={})=>s("navigate",{type:"native",screen:e,params:t}),close:(e={})=>s("close",{result:e}),requestPermission:(e,t)=>s("requestPermission",{permission:e,reason:t}),requestLocation:e=>i.requestPermission("location",e),requestCamera:e=>i.requestPermission("camera",e),requestMicrophone:e=>i.requestPermission("microphone",e),requestPhotos:e=>i.requestPermission("photos",e),requestContacts:e=>i.requestPermission("contacts",e),requestBluetooth:e=>i.requestPermission("bluetooth",e),requestNFC:e=>i.requestPermission("nfc",e),_listeners:{},on(e,t){i._listeners[e]||(i._listeners[e]=[]),i._listeners[e].push(t)},_emit(e,t){(i._listeners[e]||[]).forEach(e=>e(t))}};o&&window.addEventListener("miniapp_event",e=>{const{type:t,data:o}=e.detail||{};i._emit(t,o)});const r=i;return t})());