@kbapp/market-partner-sdk 0.0.1

package/dist/lib/share-model.d.ts

@@ -0,0 +1,171 @@
+import { CallbackOptions } from './callback-options';
+/**
+ *
+ * @description app分享model
+ */
+export declare class AppShareModel {
+    /**
+     * 标题
+     */
+    title: string;
+    /**
+     * 文字内容
+     */
+    content?: string;
+    /**
+     * 图片
+     */
+    imageUrl: string;
+    /**
+     * 分享链接
+     */
+    url: string;
+    /**
+     * 分享功能是否开启. 默认为 true.
+     * 当分享功能关闭时, 其他分享相关字段均无效.
+     */
+    enabled?: boolean;
+    /**
+     * 海报分享标题.
+     * 客户端: 海报分享必须. 若不存在则取 {@link #title}, 若也不存在, 则海报分享功能关闭.
+     * H5: 非必填. 通过桥接给到客户端时, 建议可以只填充 {@link #title}.
+     * 后端: 非必填.
+     */
+    posterTitle?: string;
+    /**
+     * 海报分享内容.
+     * 客户端: 非必须. 若不存在则取 {@link #content}, 若也不存在, 则海报只有标题内容.
+     * H5: 非必填. 通过桥接给到客户端时, 建议可以只填充 {@link #content}.
+     * 后端: 非必填.
+     */
+    posterContent?: string;
+    /**
+     * 海报分享封面图.
+     * 客户端: 海报分享非必须. 若不存在则取 {@link #imageUrl}, 若也不存在, 则海报无封面.
+     * H5: 非必填. 通过桥接给到客户端时, 建议可以只填充 {@link #imageUrl}.
+     * 后端: 非必填.
+     */
+    posterUrl?: string;
+    /**
+     * 海报分享的展示时间.
+     * 客户端: 海报分享非必须. 若不存在则海报不展示时间.
+     * H5: 非必填. 通过桥接给到客户端时, 建议忽略该字段.
+     * 后端: 非必填.
+     */
+    posterTime?: string;
+    /** 海报分享展示时间格式. */
+    posterTimeFormat?: string;
+    /**
+     * 海报分享功能是否开启. 默认为 false.
+     * 当海报分享功能关闭时, 其他海报分享相关字段均无效.
+     */
+    posterEnabled?: boolean;
+    /**
+     * 分享小程序设置: 小程序原始ID.
+     * 获取方法: 登录小程序管理后台-设置-基本设置-帐号信息.
+     *
+     * 当此字段非空时, 客户端会显示 '分享至小程序' 功能. 详见微信小程序分享文档:
+     * https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/share.html
+     */
+    wxMiniUserName?: string;
+    /**
+     * 分享小程序设置: 小程序页面路径.
+     */
+    wxMiniPath?: string;
+    /**
+     * 分享小程序设置: 额外信息.
+     * 通常开发者希望分享出去的小程序被二次打开时可以获取到更多信息, 例如群的标识.
+     */
+    wxMiniShareTicket?: boolean;
+    /**
+     * 分享小程序设置: 小程序的类型.
+     * 0为正式版, 1为测试版, 2为体验版.
+     */
+    wxMiniType?: number;
+}
+/**
+ *
+ * @description 定义app点击转发时候的分享卡片内容
+ * @example
+ * **示例代码**
+```js
+import { defineAppShareModel } from '@kbapp/market-partner-sdk';
+
+// 方式1
+defineAppShareModel({
+    title: '分享标题',
+    content: '分享内容',
+    imageUrl: 'https://static.kaiba315.com.cn/kaiba-logo.png', // 分享图片
+    url: 'http://www.kaiba315.com.cn/' // 分享网页地址
+    success() {
+        console.log('设置成功')
+    },
+    fail() {
+        console.log('设置失败')
+    }
+})
+
+// 方式2
+defineAppShareModel({
+    onShareApp() {
+        // 点击页面右上角的时候触发该回调, 定义转发内容
+        return {
+            title: '分享标题',
+            content: '分享内容',
+            imageUrl: 'https://static.kaiba315.com.cn/kaiba-logo.png', // 分享图片
+            url: 'http://www.kaiba315.com.cn/' // 分享网页地址
+        }
+    },
+    success() {
+        console.log('设置成功')
+    },
+    fail() {
+        console.log('设置失败')
+    }
+})
+```
+ */
+export declare function defineAppShareModel(params: (AppShareModel & CallbackOptions<void>) | ({
+    onShareApp: () => AppShareModel;
+} & CallbackOptions<void>)): Promise<void>;
+/**
+ *
+ * @description 主动唤起 分享面板
+ * @version 开吧APP：80801开始支持，低版本需开发者做兼容处理
+ * @example
+ * **示例代码**
+```js
+import { openAppSharePanel } from '@kbapp/market-partner-sdk';
+
+openAppSharePanel({
+    title: '开吧分享',
+    content: '开吧，开汽车上新生活！',
+    url: 'http://www.kaiba315.com.cn/',
+    imageUrl: 'https://static.kaiba315.com.cn/kaiba-logo.png',
+    success() {
+        console.log('打开分享面板成功')
+    },
+    fail() {
+        console.log('打开分享面板失败')
+    }
+})
+```
+ *
+ */
+export declare function openAppSharePanel(params: AppShareModel & CallbackOptions<void>): Promise<void>;
+/**
+ *
+ * @description 监听 分享面板打开时触发 (主动和被动)
+ * @example
+ * **示例代码**
+```js
+import { onAppSharePanelShow } from '@kbapp/market-partner-sdk';
+
+const stopHandle = onAppSharePanelShow(() => {
+    console.log('分享面板打开')
+})
+
+// stopHandle() 停止监听
+```
+ */
+export declare function onAppSharePanelShow(callback: EventListenerOrEventListenerObject): () => void;

package/dist/util/filter-undefined-properties.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 过滤对象第一层中值为 undefined 的属性（不处理嵌套对象）
+ * @param obj 待过滤的对象（仅支持纯对象，不支持数组/非对象类型）
+ * @returns 过滤后的新对象（自动剔除值为 undefined 的属性）
+ */
+export declare function filterUndefinedProperties<T extends Record<string, any>>(obj: T): Pick<T, {
+    [K in keyof T]: T[K] extends undefined ? never : K;
+}[keyof T]>;

package/dist/util/promise-cache.d.ts

@@ -0,0 +1,10 @@
+/**
+ *
+ * @description 缓存promise结果
+ */
+export declare function decorateCacheAsyncResult<CB extends (...params: any[]) => any>(cb: CB): (...params: Parameters<CB>) => ReturnType<CB>;
+/**
+ *
+ * @description 异步节流
+ */
+export declare function decorateThrottleAsync<CALLBACK extends (...params: any[]) => any>(cb: CALLBACK): (...params: Parameters<CALLBACK>) => ReturnType<CALLBACK>;

package/examples/index.html

@@ -0,0 +1,217 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>测试demo</title>
+        <link
+            href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/css/bootstrap.min.css"
+            rel="stylesheet"
+            integrity="sha384-GLhlTQ8iRABdZLl6O3oVMWSktQOp6b7In1Zl3/Jr59b6EGGoI1aFkw7cmDA6j6gD"
+            crossorigin="anonymous"
+        />
+    </head>
+    <body>
+        <div id="app">
+            <div class="card m-2" v-for="(item, index) in list" :key="index">
+                <h5 class="card-header">
+                    <div class="d-flex justify-content-between align-items-center">
+                        <span>{{item.title}}</span>
+
+                        <template v-if="item.done.status.loading">
+                            <button type="button" class="btn btn-primary" disabled>
+                                <span class="spinner-grow spinner-grow-sm" role="status" aria-hidden="true"></span>
+                            </button>
+                        </template>
+                        <template v-else>
+                            <button type="button" class="btn btn-primary" @click="item.done">{{item.buttonText}}</button>
+                        </template>
+                    </div>
+                </h5>
+
+                <div class="card-body">
+                    <template v-if="item.subtitle">
+                        <div class="card-title fw-bold">{{item.subtitle}}</div>
+                    </template>
+
+                    <template v-if="item.desc">
+                        <div class="card-text">{{item.desc}}</div>
+                    </template>
+
+                    <template v-if="item.done.status.data">
+                        <div class="alert alert-success mt-2" role="alert">{{item.done.status.data}}</div>
+                    </template>
+
+                    <template v-if="item.done.status.error">
+                        <div class="alert alert-danger mt-2" role="alert">{{item.done.status.error}}</div>
+                    </template>
+                </div>
+            </div>
+        </div>
+    </body>
+    <script type="module">
+        import { createApp, ref, reactive } from 'https://unpkg.com/vue@3/dist/vue.esm-browser.js'
+        import { getAuthToken, runAction, defineAppShareModel, openAppSharePanel, reportGetui, getAppBaseInfo, shareImage } from 'https://unpkg.com/@kbapp/market-partner-sdk@latest/dist/index.es.js'
+
+        /**
+         * 装饰器，用于处理done函数的调用
+         * @param {Function} callback - 实际执行的函数
+         * @returns {Function} - 装饰后的函数
+         */
+        const decorateDone = (callback) => {
+            /** 状态 */
+            const status = reactive({
+                /** 请求中 */
+                loading: false,
+
+                /** 请求完成 */
+                data: null,
+
+                /** 异常值 */
+                error: null,
+            })
+
+            async function done() {
+                status.data = null
+                status.error = null
+                status.loading = true
+
+                try {
+                    const data = await Promise.resolve(callback())
+                    status.data = data
+                } catch (error) {
+                    status.error = error
+                    throw error
+                } finally {
+                    status.loading = false
+                }
+            }
+
+            done['status'] = status
+
+            return done
+        }
+
+        const list = reactive([
+            {
+                title: 'runAction',
+                subtitle: '通用跳转',
+                buttonText: '执行',
+                desc: `执行结果: 跳转到百度页面`,
+                done: decorateDone(async () => {
+                    await runAction({
+                        action: 'pageWeb',
+                        actionParams: {
+                            url: 'https://www.baidu.com',
+                        },
+                    })
+                    return '执行成功'
+                }),
+            },
+            {
+                title: 'defineAppShareModel',
+                subtitle: '定义分享model',
+                buttonText: '执行',
+                desc: `执行结果: 设置点击页面右上角分享卡片内容`,
+                done: decorateDone(async () => {
+                    await defineAppShareModel({
+                        title: '分享标题',
+                        content: '分享内容',
+                        imageUrl: 'https://static.kaiba315.com.cn/kaiba-logo.png',
+                        url: 'http://www.kaiba315.com.cn/',
+                    })
+
+                    return '设置成功'
+                }),
+            },
+            {
+                title: 'getAuthToken',
+                subtitle: '强制登录 mode=force',
+                buttonText: '执行',
+                desc: `执行结果: 如果未登录则唤起登录, 登录成功后返回token`,
+                done: decorateDone(async () => {
+                    const result = await getAuthToken({
+                        mode: 'force',
+                    })
+
+                    return result
+                }),
+            },
+            {
+                title: 'getAuthToken',
+                subtitle: '静默登录 mode=silent',
+                buttonText: '执行',
+                desc: `执行结果: 如果未登录则返回code = 1, 已登录返回token`,
+                done: decorateDone(async () => {
+                    const result = await getAuthToken({
+                        mode: 'silent',
+                    })
+
+                    return result
+                }),
+            },
+            {
+                title: 'openAppSharePanel',
+                subtitle: '打开分享面板',
+                buttonText: '执行',
+                desc: `执行结果： 打开分享面板`,
+                done: decorateDone(async () => {
+                    await openAppSharePanel({
+                        title: '开吧分享',
+                        content: '开吧，开汽车上新生活！',
+                        url: 'http://www.kaiba315.com.cn/',
+                        imageUrl: 'https://static.kaiba315.com.cn/kaiba-logo.png',
+                    })
+
+                    return '执行成功'
+                }),
+            },
+            {
+                title: 'reportGetui',
+                subtitle: '上报数据埋点到个推',
+                buttonText: '执行',
+                desc: `执行结果：上报数据埋点到个推`,
+                done: decorateDone(async () => {
+                    await reportGetui({
+                        eventName: 'text_event_name',
+                        eventParams: {
+                            test_param: 'test_value',
+                        },
+                    })
+
+                    return '执行成功'
+                }),
+            },
+            {
+                title: 'getAppBaseInfo',
+                subtitle: '获取开吧 App 基础信息',
+                buttonText: '执行',
+                desc: `执行结果: 返回开吧 App 基础信息`,
+                done: decorateDone(async () => {
+                    return getAppBaseInfo()
+                }),
+            },
+            {
+                title: 'shareImage',
+                subtitle: '分享图片',
+                buttonText: '执行',
+                desc: `执行结果 分享图片`,
+                done: decorateDone(async () => {
+                    await shareImage({
+                        imageUrl: 'https://static.kaiba315.com.cn/kaiba-logo.png',
+                    })
+
+                    return '分享成功'
+                }),
+            },
+        ])
+
+        createApp({
+            setup() {
+                return {
+                    list,
+                }
+            },
+        }).mount('#app')
+    </script>
+</html>

package/package.json

@@ -0,0 +1,18 @@
+{
+    "name": "@kbapp/market-partner-sdk",
+    "version": "0.0.1",
+    "description": "开吧商城接入jssdk",
+    "publishConfig": {
+        "access": "public"
+    },
+    "main": "./dist/index.umd.js",
+    "module": "./dist/index.es.js",
+    "types": "./dist/index.d.ts",
+    "unpkg": "./dist/index.umd.js",
+    "browser": "./dist/index.umd.js",
+    "author": "along",
+    "scripts": {
+        "build": "rm -rf ./dist && vite build && npx tsc --emitDeclarationOnly",
+        "publish": "npm run build && npm publish"
+    }
+}

package/server.js

@@ -0,0 +1,103 @@
+// 简单的HTTP服务器，正确处理ES模块的MIME类型
+import http from 'http';
+import fs from 'fs';
+import path from 'path';
+
+const PORT = 8080;
+const BASE_DIR = process.cwd();
+
+const server = http.createServer((req, res) => {
+    console.log(`请求路径: ${req.url}`);
+    // 移除URL中的查询字符串
+    const urlPath = req.url.split('?')[0];
+    
+    // 特殊路径重定向逻辑
+    let redirectPath = null;
+    
+    // 重定向 /lib/bridge-code 到 /dist/lib/bridge-code
+    if (urlPath === '/lib/bridge-code') {
+        redirectPath = '/dist/lib/bridge-code';
+        console.log(`重定向路径: ${urlPath} -\u003e ${redirectPath}`);
+    }
+    // 重定向 /dist/lib/flutter-ds-bridge 到 /dist/core/lib/flutter-ds-bridge
+    else if (urlPath === '/dist/lib/flutter-ds-bridge') {
+        redirectPath = '/dist/core/lib/flutter-ds-bridge';
+        console.log(`重定向路径: ${urlPath} -\u003e ${redirectPath}`);
+    }
+    
+    // 确定文件路径
+    let filePath = path.join(BASE_DIR, redirectPath || urlPath);
+    
+    // 如果请求没有扩展名，尝试添加.js
+    if (!path.extname(urlPath)) {
+        console.log(`检测到无扩展名路径，尝试添加.js扩展名`);
+        filePath = filePath + '.js';
+    } else if (urlPath.endsWith('/')) {
+        // 如果是目录，默认返回index.html
+        filePath = path.join(filePath, 'index.html');
+    }
+    
+    // 确定MIME类型
+    const extname = path.extname(filePath);
+    let contentType = 'text/html';
+    
+    switch (extname) {
+        case '.js':
+            contentType = 'application/javascript';
+            break;
+        case '.mjs':
+            contentType = 'application/javascript';
+            break;
+        case '.css':
+            contentType = 'text/css';
+            break;
+        case '.json':
+            contentType = 'application/json';
+            break;
+        case '.png':
+            contentType = 'image/png';
+            break;
+        case '.jpg':
+        case '.jpeg':
+            contentType = 'image/jpeg';
+            break;
+    }
+    
+    console.log(`尝试加载文件: ${filePath}`);
+    
+    // 读取并发送文件
+    fs.readFile(filePath, (error, content) => {
+        if (error) {
+            console.error(`文件加载错误: ${error.message}`);
+            if (error.code === 'ENOENT') {
+                // 文件不存在，尝试备选路径/index.js
+                const altFilePath = path.join(filePath.replace('.js', ''), 'index.js');
+                console.log(`尝试备选路径: ${altFilePath}`);
+                fs.readFile(altFilePath, (altError, altContent) => {
+                    if (altError) {
+                        res.writeHead(404);
+                        res.end(`文件不存在: ${filePath}`);
+                    } else {
+                        res.writeHead(200, { 'Content-Type': contentType });
+                        res.end(altContent, 'utf-8');
+                    }
+                });
+                return;
+            }
+            
+            // 服务器错误
+            res.writeHead(500);
+            res.end('服务器错误: ' + error.code);
+        } else {
+            // 文件存在，发送内容
+            res.writeHead(200, { 'Content-Type': contentType });
+            res.end(content, 'utf-8');
+        }
+    });
+});
+
+server.listen(PORT, () => {
+    console.log(`服务器运行在 http://localhost:${PORT}`);
+    console.log(`当前工作目录: ${BASE_DIR}`);
+    console.log(`访问示例: http://localhost:${PORT}/examples/index.html`);
+});

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+    "compilerOptions": {
+        "target": "ES6",
+        "module": "ESNext",
+        "allowJs": true,
+        "strict": true,
+        "outDir": "./dist",
+        "baseUrl": "./",
+        "rootDir": "./src",
+        "declaration": true,
+        "declarationDir": "./dist",
+        "lib": [
+            "esnext",
+            "dom"
+        ],
+        "sourceMap": false,
+        "moduleResolution": "Node",
+        "esModuleInterop": true,
+        "resolveJsonModule": true
+    },
+    "include": [
+        "src"
+    ]
+}

package/vite.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+  build: {
+    lib: {
+      entry: './src/index.ts',
+      name: 'kbMarket',
+      fileName: (format) => `index.${format}.js`,
+      formats: ['es', 'umd']
+    },
+    rollupOptions: {
+      // 确保外部化处理那些你不想打包进库的依赖
+      external: [],
+      output: {
+        // 为 UMD/iife 构建提供全局变量名称
+        globals: {
+          // 如果有依赖需要全局变量映射，可以在这里配置
+        }
+      }
+    }
+  }
+});