@appboxo/web-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Finom pte. ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# Appboxo Web SDK
+
+Embed miniapps into your desktop application using iframe communication.
+
+## Quick Start
+
+```typescript
+import { AppboxoWebSDK } from "boxo-desktop-host-sdk";
+
+const sdk = new AppboxoWebSDK({
+  clientId: "your-client-id",
+  appId: "your-app-id"
+});
+
+// Get auth code from your backend
+const authCode = await fetch('/api/auth-code').then(r => r.json());
+sdk.setAuthCode(authCode);
+
+// Mount miniapp
+sdk.mount({
+  container: document.getElementById("miniapp"),
+  url: "https://your-miniapp.com"
+});
+```
+
+## Installation
+
+```bash
+npm install boxo-desktop-host-sdk
+# or
+pnpm install boxo-desktop-host-sdk
+```
+
+## Configuration
+
+```typescript
+const sdk = new AppboxoWebSDK({
+  clientId: string;      // Required
+  appId: string;         // Required
+  userId?: string;       // Optional, user reference identifier
+  baseUrl?: string;      // Optional, default: "https://dashboard.appboxo.com/api/v1"
+  debug?: boolean;        // Optional, default: false
+  onGetAuthCode?: () => Promise<string>; // Optional, for automatic auth code retrieval
+});
+```
+
+### Authentication
+
+Two approaches:
+
+**1. Set auth code explicitly**
+
+```typescript
+sdk.setAuthCode(authCode);
+```
+
+**2. Provide callback**
+
+```typescript
+const sdk = new AppboxoWebSDK({
+  clientId: "your-client-id",
+  appId: "your-app-id",
+  onGetAuthCode: async () => {
+    const res = await fetch('/api/generate-auth-code');
+    return (await res.json()).auth_code;
+  }
+});
+```
+
+The SDK will try these in order:
+
+1. Explicitly set auth code
+2. Callback function
+3. Mock auth code (fallback)
+
+## Methods
+
+| Method | Description |
+|--------|-------------|
+| `setAuthCode(code)` | Set authentication code |
+| `mount(config)` | Create iframe and initialize SDK |
+| `setIframe(iframe)` | Set iframe element manually |
+| `initialize()` | Start listening for events |
+| `onEvent(type, handler)` | Register custom event handler |
+| `onLoginComplete(callback)` | Login completion callback |
+| `onPaymentComplete(callback)` | Payment completion callback |
+| `destroy()` | Clean up resources |
+
+## Events
+
+SDK handles these miniapp events:
+
+- `AppBoxoWebAppLogin` - User authentication
+- `AppBoxoWebAppPay` - Payment processing
+- `AppBoxoWebAppGetInitData` - Initial data request
+- `AppBoxoWebAppCustomEvent` - Custom events
+
+## Examples
+
+### React Example
+
+```tsx
+function App() {
+  const iframeRef = useRef<HTMLIFrameElement>(null);
+  const [sdk, setSdk] = useState<AppboxoWebSDK | null>(null);
+
+  useEffect(() => {
+    const s = new AppboxoWebSDK({ clientId: "...", appId: "..." });
+    s.setAuthCode(authCode);
+    s.onLoginComplete((success) => {
+      console.log('Login:', success ? 'success' : 'failed');
+    });
+    setSdk(s);
+    return () => s.destroy();
+  }, []);
+
+  const handleLoad = () => {
+    if (sdk && iframeRef.current) {
+      sdk.setIframe(iframeRef.current);
+      sdk.initialize();
+    }
+  };
+
+  return <iframe ref={iframeRef} onLoad={handleLoad} src="..." />;
+}
+```
+
+### Using mount helper
+
+```typescript
+sdk.mount({
+  container: '#miniapp-container',
+  url: 'https://miniapp.com',
+  width: '100%',
+  height: '600px'
+});
+```
+
+## License
+
+Apache-2.0

package/dist/constants.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2024 Boxo pte. ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Default SDK configuration
+ */
+export declare const DEFAULT_CONFIG: {
+    readonly baseUrl: "https://dashboard.appboxo.com/api/v1";
+    readonly sandboxMode: false;
+    readonly debug: false;
+};
+/**
+ * Allowed origins for security validation
+ */
+export declare const ALLOWED_ORIGINS: {
+    readonly production: readonly ["https://esim-finom-desktop.vercel.app", "https://staging.esim-finom-desktop.com"];
+    readonly development: readonly ["http://localhost:3000"];
+};
+/**
+ * SDK event types
+ */
+export declare const EVENT_TYPES: {
+    readonly LOGIN: "AppBoxoWebAppLogin";
+    readonly PAYMENT: "AppBoxoWebAppPay";
+    readonly INIT_DATA: "AppBoxoWebAppGetInitData";
+    readonly CUSTOM: "AppBoxoWebAppCustomEvent";
+};
+/**
+ * SDK message type identifier
+ */
+export declare const SDK_MESSAGE_TYPE = "appboxo-js-sdk";
+/**
+ * SDK version
+ */
+export declare const SDK_VERSION = "1.0.0";
+/**
+ * Error codes
+ */
+export declare const ERROR_CODES: {
+    readonly INVALID_ORIGIN: 400;
+    readonly MISSING_IFRAME: 400;
+    readonly AUTHENTICATION_FAILED: 401;
+    readonly PAYMENT_FAILED: 402;
+    readonly UNSUPPORTED_EVENT: 404;
+    readonly UNKNOWN: 500;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;CAQlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC"}

package/dist/constants.js

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2024 Boxo pte. ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Default SDK configuration
+ */
+export const DEFAULT_CONFIG = {
+    baseUrl: 'https://dashboard.appboxo.com/api/v1',
+    sandboxMode: false,
+    debug: false,
+};
+/**
+ * Allowed origins for security validation
+ */
+export const ALLOWED_ORIGINS = {
+    production: [
+        'https://esim-finom-desktop.vercel.app',
+        'https://staging.esim-finom-desktop.com',
+    ],
+    development: [
+        'http://localhost:3000',
+    ],
+};
+/**
+ * SDK event types
+ */
+export const EVENT_TYPES = {
+    LOGIN: 'AppBoxoWebAppLogin',
+    PAYMENT: 'AppBoxoWebAppPay',
+    INIT_DATA: 'AppBoxoWebAppGetInitData',
+    CUSTOM: 'AppBoxoWebAppCustomEvent',
+};
+/**
+ * SDK message type identifier
+ */
+export const SDK_MESSAGE_TYPE = 'appboxo-js-sdk';
+/**
+ * SDK version
+ */
+export const SDK_VERSION = '1.0.0';
+/**
+ * Error codes
+ */
+export const ERROR_CODES = {
+    INVALID_ORIGIN: 400,
+    MISSING_IFRAME: 400,
+    AUTHENTICATION_FAILED: 401,
+    PAYMENT_FAILED: 402,
+    UNSUPPORTED_EVENT: 404,
+    UNKNOWN: 500,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,sCAAsC;IAC/C,WAAW,EAAE,KAAK;IAClB,KAAK,EAAE,KAAK;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE;QACV,uCAAuC;QACvC,wCAAwC;KACzC;IACD,WAAW,EAAE;QACX,uBAAuB;KACxB;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,oBAAoB;IAC3B,OAAO,EAAE,kBAAkB;IAC3B,SAAS,EAAE,0BAA0B;IACrC,MAAM,EAAE,0BAA0B;CAC1B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc,EAAE,GAAG;IACnB,cAAc,EAAE,GAAG;IACnB,qBAAqB,EAAE,GAAG;IAC1B,cAAc,EAAE,GAAG;IACnB,iBAAiB,EAAE,GAAG;IACtB,OAAO,EAAE,GAAG;CACJ,CAAC"}

package/dist/handlers/customEventHandler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Custom Event Handler
+ * Handles custom events from miniapp
+ */
+import type { CustomEventHandler } from '../types';
+export interface CustomEventHandlerConfig {
+    eventHandlers: Map<string, CustomEventHandler>;
+    log: (message: string, data?: any) => void;
+    sendResponseToMiniapp: (response: any) => void;
+    sendErrorResponse: (eventType: string, error: any, requestId?: string | number) => void;
+}
+/**
+ * Handle custom events
+ */
+export declare function handleCustomEvent(params: any, requestId: string | number | undefined, config: CustomEventHandlerConfig): Promise<void>;
+//# sourceMappingURL=customEventHandler.d.ts.map

package/dist/handlers/customEventHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customEventHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/customEventHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC3C,qBAAqB,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;CACzF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,GAAG,EACX,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACtC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/handlers/customEventHandler.js

@@ -0,0 +1,27 @@
+/**
+ * Custom Event Handler
+ * Handles custom events from miniapp
+ */
+import { EVENT_TYPES } from '../constants';
+import { createHostResponse } from '../utils/messageHelpers';
+/**
+ * Handle custom events
+ */
+export async function handleCustomEvent(params, requestId, config) {
+    try {
+        const { type, payload } = params;
+        const handler = config.eventHandlers.get(type);
+        if (!handler) {
+            throw new Error(`No handler registered for custom event: ${type}`);
+        }
+        const result = await handler(type, payload);
+        const response = createHostResponse(EVENT_TYPES.CUSTOM, result, requestId);
+        config.sendResponseToMiniapp(response);
+        config.log('Custom event handled', { type, result });
+    }
+    catch (error) {
+        config.log('Custom event failed', error);
+        config.sendErrorResponse('AppBoxoWebAppCustomEvent', error, requestId);
+    }
+}
+//# sourceMappingURL=customEventHandler.js.map

package/dist/handlers/customEventHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customEventHandler.js","sourceRoot":"","sources":["../../src/handlers/customEventHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAU7D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAW,EACX,SAAsC,EACtC,MAAgC;IAEhC,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE5C,MAAM,QAAQ,GAAG,kBAAkB,CACjC,WAAW,CAAC,MAAM,EAClB,MAAM,EACN,SAAS,CACV,CAAC;QACF,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEvC,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/handlers/initDataHandler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Init Data Handler
+ * Handles init data events from miniapp
+ */
+import type { InitDataRequest, SDKConfig } from '../types';
+export interface InitDataHandlerConfig {
+    config: SDKConfig;
+    log: (message: string, data?: any) => void;
+    sendResponseToMiniapp: (response: any) => void;
+    sendErrorResponse: (eventType: string, error: any, requestId?: string | number) => void;
+}
+/**
+ * Handle init data events
+ */
+export declare function handleInitDataEvent(params: InitDataRequest, requestId: string | number | undefined, config: InitDataHandlerConfig): Promise<void>;
+//# sourceMappingURL=initDataHandler.d.ts.map

package/dist/handlers/initDataHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initDataHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/initDataHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAoB,SAAS,EAAE,MAAM,UAAU,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC3C,qBAAqB,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;CACzF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACtC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/handlers/initDataHandler.js

@@ -0,0 +1,29 @@
+/**
+ * Init Data Handler
+ * Handles init data events from miniapp
+ */
+import { EVENT_TYPES } from '../constants';
+import { createHostResponse } from '../utils/messageHelpers';
+/**
+ * Handle init data events
+ */
+export async function handleInitDataEvent(params, requestId, config) {
+    try {
+        config.log('Handling init data event', params);
+        const initData = {
+            app_id: params.app_id,
+            client_id: params.client_id,
+            payload: params.payload,
+            data: params.data || {},
+            sandbox_mode: config.config.sandboxMode
+        };
+        const response = createHostResponse(EVENT_TYPES.INIT_DATA, initData, requestId);
+        config.sendResponseToMiniapp(response);
+        config.log('Init data sent', initData);
+    }
+    catch (error) {
+        config.log('Init data failed', error);
+        config.sendErrorResponse('AppBoxoWebAppGetInitData', error, requestId);
+    }
+}
+//# sourceMappingURL=initDataHandler.js.map

package/dist/handlers/initDataHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initDataHandler.js","sourceRoot":"","sources":["../../src/handlers/initDataHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAU7D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAuB,EACvB,SAAsC,EACtC,MAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAqB;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;YACvB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW;SACxC,CAAC;QAEF,MAAM,QAAQ,GAAG,kBAAkB,CACjC,WAAW,CAAC,SAAS,EACrB,QAAQ,EACR,SAAS,CACV,CAAC;QACF,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEvC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/handlers/loginHandler.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Login Handler
+ * Handles authentication events from miniapp
+ */
+import type { LoginRequest, SDKConfig, LifecycleEventHandler } from '../types';
+export interface LoginHandlerConfig {
+    config: SDKConfig;
+    authCode: string | null;
+    onGetAuthCode?: () => Promise<string>;
+    lifecycleHandlers: Map<string, LifecycleEventHandler>;
+    log: (message: string, data?: any) => void;
+    sendResponseToMiniapp: (response: any) => void;
+    sendErrorResponse: (eventType: string, error: any, requestId?: string | number) => void;
+}
+/**
+ * Handle login events
+ *
+ * Desktop SDK flow:
+ * 1. Miniapp calls appboxo.login()
+ * 2. Generate authCode from Desktop App session
+ * 3. Call Boxo Platform API to get auth_token
+ * 4. Return auth_token to miniapp
+ */
+export declare function handleLoginEvent(params: LoginRequest, requestId: string | number | undefined, config: LoginHandlerConfig): Promise<void>;
+//# sourceMappingURL=loginHandler.d.ts.map

package/dist/handlers/loginHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loginHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/loginHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACtD,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC3C,qBAAqB,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;CACzF;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACtC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CAyCf"}

package/dist/handlers/loginHandler.js

@@ -0,0 +1,50 @@
+/**
+ * Login Handler
+ * Handles authentication events from miniapp
+ */
+import { EVENT_TYPES } from '../constants';
+import { createHostResponse } from '../utils/messageHelpers';
+import { generateAuthCode, exchangeAuthCodeForTokens } from '../utils/authHelper';
+/**
+ * Handle login events
+ *
+ * Desktop SDK flow:
+ * 1. Miniapp calls appboxo.login()
+ * 2. Generate authCode from Desktop App session
+ * 3. Call Boxo Platform API to get auth_token
+ * 4. Return auth_token to miniapp
+ */
+export async function handleLoginEvent(params, requestId, config) {
+    try {
+        config.log('Handling login event', params);
+        // Generate auth code
+        const authHelperConfig = {
+            config: config.config,
+            authCode: config.authCode,
+            onGetAuthCode: config.onGetAuthCode,
+            log: config.log
+        };
+        const authCode = await generateAuthCode(authHelperConfig);
+        // Exchange auth code for tokens
+        const { token, refresh_token } = await exchangeAuthCodeForTokens(authCode, authHelperConfig);
+        // Return token to miniapp
+        const response = createHostResponse(EVENT_TYPES.LOGIN, {
+            payload: {
+                token,
+                refresh_token
+            }
+        }, requestId);
+        config.log('Login response structure', JSON.stringify(response, null, 2));
+        config.sendResponseToMiniapp(response);
+        config.log('Login successful', { token, refresh_token });
+        // Call login complete callback if registered
+        const callback = config.lifecycleHandlers.get('login-complete');
+        if (callback)
+            callback(true, { token, refresh_token });
+    }
+    catch (error) {
+        config.log('Login failed', error);
+        config.sendErrorResponse('AppBoxoWebAppLogin', error, requestId);
+    }
+}
+//# sourceMappingURL=loginHandler.js.map

package/dist/handlers/loginHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loginHandler.js","sourceRoot":"","sources":["../../src/handlers/loginHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAkBlF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAoB,EACpB,SAAsC,EACtC,MAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;QAE3C,qBAAqB;QACrB,MAAM,gBAAgB,GAAqB;YACzC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QAE1D,gCAAgC;QAChC,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAE7F,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,kBAAkB,CACjC,WAAW,CAAC,KAAK,EACjB;YACE,OAAO,EAAE;gBACP,KAAK;gBACL,aAAa;aACd;SACF,EACD,SAAS,CACV,CAAC;QAEF,MAAM,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEvC,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAEzD,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAChE,IAAI,QAAQ;YAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,iBAAiB,CAAC,oBAAoB,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/handlers/paymentHandler.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Payment Handler
+ * Handles payment events from miniapp
+ */
+import type { PaymentRequest } from '../types';
+export interface PaymentHandlerConfig {
+    log: (message: string, data?: any) => void;
+    sendResponseToMiniapp: (response: any) => void;
+    sendErrorResponse: (eventType: string, error: any, requestId?: string | number) => void;
+}
+/**
+ * Handle payment events
+ */
+export declare function handlePaymentEvent(params: PaymentRequest, requestId: string | number | undefined, config: PaymentHandlerConfig): Promise<void>;
+//# sourceMappingURL=paymentHandler.d.ts.map

package/dist/handlers/paymentHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/paymentHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC3C,qBAAqB,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;CACzF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACtC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/handlers/paymentHandler.js

@@ -0,0 +1,34 @@
+/**
+ * Payment Handler
+ * Handles payment events from miniapp
+ */
+import { EVENT_TYPES } from '../constants';
+import { createHostResponse } from '../utils/messageHelpers';
+import { processFinomPayment } from '../utils/paymentHelper';
+/**
+ * Handle payment events
+ */
+export async function handlePaymentEvent(params, requestId, config) {
+    try {
+        config.log('Handling payment event', params);
+        // Process payment through Finom
+        const paymentConfig = {
+            log: config.log
+        };
+        const result = await processFinomPayment(params, paymentConfig);
+        // Send success response
+        const response = createHostResponse(EVENT_TYPES.PAYMENT, {
+            status: result.status,
+            hostappOrderId: result.orderId,
+            transactionToken: params.transactionToken,
+            ...(result.transactionId && { transactionId: result.transactionId })
+        }, requestId);
+        config.sendResponseToMiniapp(response);
+        config.log('Payment processed', result);
+    }
+    catch (error) {
+        config.log('Payment failed', error);
+        config.sendErrorResponse('AppBoxoWebAppPay', error, requestId);
+    }
+}
+//# sourceMappingURL=paymentHandler.js.map

package/dist/handlers/paymentHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentHandler.js","sourceRoot":"","sources":["../../src/handlers/paymentHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAU7D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAsB,EACtB,SAAsC,EACtC,MAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;QAE7C,gCAAgC;QAChC,MAAM,aAAa,GAAwB;YACzC,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAEhE,wBAAwB;QACxB,MAAM,QAAQ,GAAG,kBAAkB,CACjC,WAAW,CAAC,OAAO,EACnB;YACE,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,cAAc,EAAE,MAAM,CAAC,OAAO;YAC9B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;SACrE,EACD,SAAS,CACV,CAAC;QACF,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEvC,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2024 Boxo pte. ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { SDKConfig, CustomEventHandler } from './types';
+/**
+ * Appboxo Web SDK for Desktop
+ * Handles communication between Desktop App and miniapps
+ */
+declare class AppboxoWebSDK {
+    private config;
+    private iframeRef;
+    private eventHandlers;
+    private lifecycleHandlers;
+    private requestResolvers;
+    private baseUrl;
+    private isInitialized;
+    private authCode;
+    constructor(config: SDKConfig);
+    /**
+     * Initialize the SDK and start listening for events
+     */
+    initialize(): void;
+    /**
+     * Set the iframe reference for miniapp communication
+     */
+    setIframe(iframe: HTMLIFrameElement): void;
+    /**
+     * Mount miniapp to container (helper method)
+     * Creates iframe, sets reference, and initializes SDK
+     *
+     * @param config Configuration object with container, url, and optional styles
+     * @returns The created iframe element
+     */
+    mount(config: {
+        container: string | HTMLElement;
+        url: string;
+        width?: string;
+        height?: string;
+        className?: string;
+    }): HTMLIFrameElement;
+    /**
+     * Register custom event handler
+     */
+    onEvent(eventType: string, handler: CustomEventHandler): void;
+    /**
+     * Remove event handler
+     */
+    offEvent(eventType: string): void;
+    /**
+     * Register callback for when login completes
+     */
+    onLoginComplete(callback: (success: boolean, data?: any) => void): void;
+    /**
+     * Register callback for when payment completes
+     */
+    onPaymentComplete(callback: (success: boolean, data?: any) => void): void;
+    /**
+     * Set auth code explicitly (like React Native SDK pattern)
+     */
+    setAuthCode(authCode: string): void;
+    /**
+     * Setup event listeners for miniapp communication
+     */
+    private setupEventListeners;
+    /**
+     * Handle incoming events from miniapp
+     */
+    private handleMiniappEvent;
+    /**
+     * Send response back to miniapp
+     */
+    private sendResponseToMiniapp;
+    /**
+     * Send error response to miniapp
+     */
+    private sendErrorResponse;
+    /**
+     * Logging utility
+     */
+    private log;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+export { AppboxoWebSDK };
+export default AppboxoWebSDK;
+export type { SDKConfig, MiniappEvent, HostAppResponse, LoginRequest, PaymentRequest, InitDataRequest, LoginResponse, PaymentResponse, InitDataResponse, CustomEventHandler, LifecycleEventHandler, FinomLoginCredentials, FinomAuthTokens, FinomPaymentResult, } from './types';
+export * from './utils';
+export * from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,KAAK,EACV,SAAS,EAST,kBAAkB,EAMnB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,iBAAiB,CAAiD;IAC1E,OAAO,CAAC,gBAAgB,CAAsD;IAC9E,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,MAAM,EAAE,SAAS;IAW7B;;OAEG;IACI,UAAU,IAAI,IAAI;IAWzB;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAKjD;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,EAAE;QACnB,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC;QAChC,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,iBAAiB;IA8BrB;;OAEG;IACI,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKpE;;OAEG;IACI,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxC;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAI9E;;OAEG;IACI,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAIhF;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkE1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACI,OAAO,IAAI,IAAI;CASvB;AAGD,OAAO,EAAE,aAAa,EAAE,CAAC;AAGzB,eAAe,aAAa,CAAC;AAG7B,YAAY,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC"}