fmode-ng 0.0.231 → 0.0.233

package/lib/core/ecom/shopee/src/public.d.ts

@@ -0,0 +1,204 @@
+import { ShopeeClient } from './client';
+import { ApiResponse } from './types';
+/**
+ * Shopee Public API Class
+ * Handles public/partner-level operations that don't require shop_id or main_account_id
+ */
+export declare class ShopeePublic {
+    private client;
+    constructor(client: ShopeeClient);
+    /**
+     * Generate authorization URL for merchant/shop linking
+     * @param redirectUri Callback URL after authorization
+     */
+    generateAuthUrl(redirectUri: string): Promise<ApiResponse<{
+        auth_url: string;
+        partner_id: number;
+        environment: string;
+        expires_in: number;
+    }>>;
+    /**
+     * Generate cancel authorization URL
+     * @param redirectUri Callback URL after cancellation
+     */
+    generateCancelAuthUrl(redirectUri: string): Promise<ApiResponse<{
+        cancel_auth_url: string;
+        partner_id: number;
+        environment: string;
+        expires_in: number;
+    }>>;
+    /**
+     * Get partner configuration information
+     */
+    getConfig(): Promise<ApiResponse<{
+        partner_id: number;
+        environment: string;
+        auth_url: string;
+        token_urls: {
+            get_token: string;
+            refresh_token: string;
+        };
+        timestamp: number;
+    }>>;
+    /**
+     * Check API health status
+     */
+    healthCheck(): Promise<ApiResponse<{
+        status: string;
+        service: string;
+        timestamp: number;
+        environment: string;
+        partner_id: number;
+    }>>;
+    /**
+     * Verify API signature (for debugging and testing)
+     * @param path API path
+     * @param params Request parameters
+     * @param timestamp Request timestamp
+     */
+    verifySignature(path: string, params: Record<string, any>, timestamp: number): Promise<ApiResponse<{
+        base_string: string;
+        signature: string;
+        partner_id: number;
+        environment: string;
+    }>>;
+    /**
+     * Get public category tree for a region
+     * @param region Region code (e.g., 'sg', 'my', 'th', 'tw', 'ph', 'vn', 'id')
+     */
+    getPublicCategories(region: string): Promise<ApiResponse<any>>;
+    /**
+     * Get public item details (without authentication)
+     * @param itemId Item ID
+     * @param shopId Shop ID
+     * @param region Region code
+     */
+    getPublicItemDetail(itemId: number, shopId: number, region: string): Promise<ApiResponse<any>>;
+    /**
+     * Search public items
+     * @param options Search options
+     */
+    searchPublicItems(options: {
+        keyword?: string;
+        region: string;
+        category_id?: number;
+        limit?: number;
+        offset?: number;
+        sort_by?: 'relevance' | 'price_asc' | 'price_desc' | 'sales' | 'rating';
+        min_price?: number;
+        max_price?: number;
+    }): Promise<ApiResponse<{
+        items?: Array<{
+            item_id: number;
+            shop_id: number;
+            name: string;
+            price: number;
+            currency: string;
+            image: string;
+            rating?: number;
+            sales?: number;
+        }>;
+        total_count?: number;
+        has_more?: boolean;
+    }>>;
+    /**
+     * Get public shop information
+     * @param shopId Shop ID
+     * @param region Region code
+     */
+    getPublicShopInfo(shopId: number, region: string): Promise<ApiResponse<any>>;
+    /**
+     * Get public shop items
+     * @param shopId Shop ID
+     * @param region Region code
+     * @param options Pagination options
+     */
+    getPublicShopItems(shopId: number, region: string, options?: {
+        limit?: number;
+        offset?: number;
+        status?: 'NORMAL' | 'UNLIST';
+        sort_by?: 'created_time_desc' | 'created_time_asc' | 'price_asc' | 'price_desc';
+    }): Promise<ApiResponse<{
+        items?: Array<{
+            item_id: number;
+            name: string;
+            price: number;
+            currency: string;
+            image: string;
+            stock: number;
+            status: string;
+        }>;
+        total_count?: number;
+        has_more?: boolean;
+    }>>;
+    /**
+     * Get regional logistics information
+     * @param region Region code
+     */
+    getPublicLogistics(region: string): Promise<ApiResponse<{
+        channels?: Array<{
+            channel_id: number;
+            name: string;
+            shipping_fee?: number;
+            estimated_days?: number;
+            enabled: boolean;
+        }>;
+    }>>;
+    /**
+     * Get exchange rates
+     * @param fromCurrency Source currency
+     * @param toCurrency Target currency
+     */
+    getExchangeRates(fromCurrency?: string, toCurrency?: string): Promise<ApiResponse<{
+        rates?: Array<{
+            from_currency: string;
+            to_currency: string;
+            rate: number;
+            updated_time: number;
+        }>;
+    }>>;
+    /**
+     * Get marketplace statistics
+     * @param region Region code
+     */
+    getMarketplaceStats(region: string): Promise<ApiResponse<{
+        total_sellers?: number;
+        total_products?: number;
+        top_categories?: Array<{
+            category_id: number;
+            name: string;
+            product_count: number;
+        }>;
+        updated_time?: number;
+    }>>;
+    /**
+     * Get trending items
+     * @param region Region code
+     * @param category Optional category filter
+     */
+    getTrendingItems(region: string, category?: number): Promise<ApiResponse<{
+        items?: Array<{
+            item_id: number;
+            shop_id: number;
+            name: string;
+            price: number;
+            currency: string;
+            image: string;
+            trending_score?: number;
+        }>;
+        updated_time?: number;
+    }>>;
+    /**
+     * Validate webhook signature
+     * @param payload Webhook payload
+     * @param signature Webhook signature
+     */
+    validateWebhook(payload: any, signature: string): Promise<ApiResponse<{
+        valid: boolean;
+        partner_id: number;
+    }>>;
+    /**
+     * Get the underlying client instance
+     */
+    getClient(): ShopeeClient;
+}

package/lib/core/ecom/shopee/src/shop.d.ts

@@ -0,0 +1,177 @@
+import { ShopeeClient } from './client';
+import { ApiResponse, ProductItem, ShopInfo } from './types';
+/**
+ * Shopee Shop API Class
+ * Handles shop-specific operations using a shop_id
+ */
+export declare class ShopeeShop {
+    private client;
+    private shopId;
+    constructor(client: ShopeeClient, shopId: number);
+    /**
+     * Get shop information
+     */
+    getShopInfo(): Promise<ApiResponse<ShopInfo>>;
+    /**
+     * Get shop categories
+     */
+    getCategories(): Promise<ApiResponse<any>>;
+    /**
+     * Get shop comment
+     */
+    getComments(options: any): Promise<ApiResponse<any>>;
+    /**
+     * Get product list
+     * @param options Query options for pagination and filtering
+     */
+    getProductList(options?: {
+        page_size?: number;
+        offset?: number;
+        cursor?: string;
+        item_status?: 'NORMAL' | 'UNLIST' | 'DELETED' | 'BANNED';
+        include_deleted_items?: boolean;
+        product_type?: 'NORMAL' | 'PRE_ORDER';
+        update_time_from?: number;
+        update_time_to?: number;
+    }): Promise<ApiResponse<{
+        item?: ProductItem[];
+        next_cursor?: string;
+        has_more_page?: boolean;
+    }>>;
+    /**
+     * Get product details
+     * @param itemId Product ID
+     */
+    getProductDetail(itemId: number): Promise<ApiResponse<ProductItem>>;
+    /**
+     * Add a new product
+     * @param productData Product information
+     */
+    addProduct(productData: {
+        name: string;
+        description: string;
+        category_id: number;
+        price: number;
+        stock: number;
+        images: string[];
+        attributes?: Record<string, any>;
+        logistics?: Array<{
+            logistic_id: number;
+            enabled: boolean;
+        }>;
+        weight?: number;
+        dimension?: {
+            length: number;
+            width: number;
+            height: number;
+        };
+    }): Promise<ApiResponse<{
+        item_id: number;
+    }>>;
+    /**
+     * Update product information
+     * @param itemId Product ID
+     * @param updateData Update information
+     */
+    updateProduct(itemId: number, updateData: {
+        name?: string;
+        description?: string;
+        price?: number;
+        stock?: number;
+        images?: string[];
+        attributes?: Record<string, any>;
+        logistics?: Array<{
+            logistic_id: number;
+            enabled: boolean;
+        }>;
+        weight?: number;
+        dimension?: {
+            length: number;
+            width: number;
+            height: number;
+        };
+    }): Promise<ApiResponse<{
+        item_id: number;
+    }>>;
+    /**
+     * Delete a product
+     * @param itemId Product ID
+     */
+    deleteProduct(itemId: number): Promise<ApiResponse<{
+        item_id: number;
+    }>>;
+    /**
+     * Unlist a product (remove from sale but don't delete)
+     * @param itemId Product ID
+     */
+    unlistProduct(itemId: number): Promise<ApiResponse<{
+        item_id: number;
+    }>>;
+    /**
+     * Get shop order list
+     * @param options Query options for pagination and filtering
+     */
+    getOrderList(options?: {
+        page_size?: number;
+        cursor?: string;
+        order_status?: 'UNPAID' | 'READY_TO_SHIP' | 'COMPLETED' | 'IN_CANCEL' | 'CANCELLED' | 'TO_RETURN' | 'RETURNED';
+        create_time_from?: number;
+        create_time_to?: number;
+        update_time_from?: number;
+        update_time_to?: number;
+        response?: 'ALL' | 'TIMEOUT';
+    }): Promise<ApiResponse<{
+        orders?: Array<{
+            order_sn: string;
+            order_status: string;
+            create_time: number;
+            update_time: number;
+            total_amount: number;
+            currency: string;
+            pay_time?: number;
+            ship_by_date?: number;
+            package_list?: Array<{
+                package_no: string;
+                tracking_number?: string;
+                shipping_carrier?: string;
+            }>;
+        }>;
+        next_cursor?: string;
+        has_more_page?: boolean;
+    }>>;
+    /**
+     * Get order details
+     * @param orderSn Order serial number
+     */
+    getOrderDetail(orderSn: string): Promise<ApiResponse<any>>;
+    /**
+     * Get shop performance metrics
+     */
+    getPerformanceMetrics(): Promise<ApiResponse<any>>;
+    /**
+     * Get shop logistics information
+     */
+    getLogistics(): Promise<ApiResponse<any>>;
+    /**
+     * Get shop discount and promotion information
+     */
+    getDiscounts(): Promise<ApiResponse<any>>;
+    /**
+     * Get shop analytics data
+     * @param options Query options for time range and metrics
+     */
+    getAnalytics(options?: {
+        start_date?: string;
+        end_date?: string;
+        metrics?: string[];
+        granularity?: 'daily' | 'weekly' | 'monthly';
+    }): Promise<ApiResponse<any>>;
+    /**
+     * Get the shop ID
+     */
+    getShopId(): number;
+    /**
+     * Get the underlying client instance
+     */
+    getClient(): ShopeeClient;
+}

package/lib/core/ecom/shopee/src/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * SDK Configuration Options
+ */
+export interface ShopeeSDKConfig {
+    /** Server base URL where the forwarding API is hosted */
+    serverUrl: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Additional headers to include in requests */
+    headers?: Record<string, string>;
+}
+/**
+ * API Request Options
+ */
+export interface RequestOptions {
+    /** HTTP method (GET, POST, PUT, DELETE) */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** API path (e.g., '/api/v2/product/get_item_list') */
+    path: string;
+    /** Query parameters */
+    query?: Record<string, any>;
+    /** Request body data */
+    body?: any;
+}
+/**
+ * API Response
+ */
+export interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    message?: string;
+    request_info?: {
+        shop_id: number;
+        method: string;
+        path: string;
+        timestamp: number;
+    };
+}
+/**
+ * Authorization Required Response
+ */
+export interface AuthRequiredResponse {
+    success: false;
+    error: 'AUTH_REQUIRED' | 'AUTH_EXPIRED';
+    message: string;
+    data: {
+        auth_url: string;
+        shop_id: number;
+        redirect_uri: string;
+    };
+}
+/**
+ * API Error Response
+ */
+export interface ApiErrorResponse {
+    success: false;
+    error: string;
+    message: string;
+    data: {
+        status_code: number;
+        api_response: any;
+        request_info: {
+            shop_id: number;
+            method: string;
+            path: string;
+            timestamp: number;
+        };
+    };
+}
+/**
+ * Shop Information
+ */
+export interface ShopInfo {
+    shop_id: number;
+    shop_name?: string;
+    region?: string;
+    status?: string;
+}
+/**
+ * Merchant Information
+ */
+export interface MerchantInfo {
+    merchant_id: number;
+    merchant_name?: string;
+    region?: string;
+    status?: string;
+}
+/**
+ * Product Item
+ */
+export interface ProductItem {
+    item_id: number;
+    shop_id: number;
+    item_name: string;
+    description?: string;
+    price?: number;
+    stock?: number;
+    status?: string;
+    created_time?: number;
+    update_time?: number;
+}

package/lib/core/index.d.ts

@@ -5,3 +5,4 @@ export * from "./social";
 export * from "./storage";
 export * from "./storage/util-file-md5";
 export * from "./storage/util-file-metadata";
+export * from "./ecom";

package/lib/core/parse/fmode.cloud.d.ts

@@ -1,4 +1,3 @@
-import { FmodeConfig } from './types';
 export interface CloudFunctionRequest {
     params: any;
     user?: any;
@@ -11,12 +10,14 @@ export interface CloudFunctionResponse {
 }
 export type CloudFunction = (request: CloudFunctionRequest, response: CloudFunctionResponse) => void;
 export declare class FmodeCloud {
-    private static _instance;
-    private _config;
+    private static _singletonInstance;
     private _cloudFunctions;
     private constructor();
     static getInstance(): FmodeCloud;
-    bindInstance(config: FmodeConfig): void;
+    static _instance: any;
+    static bindInstance(instance: any): void;
+    private get currentConfig();
+    static get instance(): any;
     define(functionName: string, cloudFunction: CloudFunction): void;
     run(functionName: string, params?: any, options?: any): Promise<any>;
     afterDelete(className: string, func: CloudFunction): Promise<void>;

package/lib/user/account/account.service.d.ts

@@ -9,6 +9,10 @@ export declare class AccountService {
     private http;
     company: string;
     billing: any;
+    private billingCache;
+    private billingCachePromise;
+    private billingCacheTime;
+    private readonly CACHE_EXPIRY_TIME;
     profile: FmodeObject | any;
     wxAppId: string;
     wxpayEnabled: boolean;
@@ -17,6 +21,7 @@ export declare class AccountService {
     constructor(ncloud: NovaCloudService, authServ: AuthService, http: HttpClient);
     getProfile(): Promise<void>;
     getBilling(): Promise<any>;
+    private fetchBillingData;
     getUserOpenid(): Promise<void>;
     authWechat(url?: string): void;
     getQueryStringByName(name: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fmode-ng",
-  "version": "0.0.231",
+  "version": "0.0.233",
   "author": "未来全栈",
   "license": "COPYRIGHT © 未来飞马 未来全栈 www.fmode.cn All RIGHTS RESERVED",
   "exports": {
@@ -74,6 +74,7 @@
     "@awesome-cordova-plugins/core": "^7.0.0 || ^8.0.0",
     "@awesome-cordova-plugins/media-capture": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0",
     "@wecom/jssdk": "^2.2.4",
+    "dingtalk-jsapi": "^3.2.0",
     "quill": "^2.0.0",
     "plupload": "^2.0.0 || 2.3.9",
     "swiper": "^10.0.0 || ^11.0.0",