/**
 * 名片分享带卡 ID · 前端契约测试(2026-10-28)
 *
 * 背景:
 *   小程序端「我的名片」组件(diy-card-self)的「发送名片」按钮是 <button open-type="share">,
 *   微信只认**页面级** onShareAppMessage。承载该组件的 DIY 页自带 onShareAppMessage
 *   (common/js/diy.js) → Vue2 defaultStrat(子覆盖父)会顶掉全局兜底 mixin
 *   (common/js/mp-share-default.js)里那段 dataset.cardId 分支
 *   → 分享 path 不带 card_id, 访客打开看到的是企业兜底卡而不是分享者那张卡。
 *
 * 修法(前端侧):
 *   ① common/js/card-share.js(新增): 三条取 card_id 的通道
 *      dataset(发送给朋友) / storage(朋友圈) / 路由 query(落地回传)
 *   ② common/js/diy.js: 页面级分享钩子把 card_id 拼进分享 path
 *   ③ components-diy/diy-card-mini.vue: 分享按钮 @tap 记住当前卡片(storage 通道)
 *   ④ components-diy/diy-card-self.vue: 从路由 query 取 card_id 回传 /card/api/diy/mycard
 *
 * 跑法: node --test tests/card-share-card-id.test.js
 */

'use strict';

const test = require('node:test');
const assert = require('node:assert/strict');
const fs = require('fs');
const path = require('path');

const ROOT = path.resolve(__dirname, '..');
const read = f => fs.readFileSync(path.join(ROOT, f), 'utf8');
const strip = s => s
    .replace(/<!--[\s\S]*?-->/g, '')
    .replace(/\/\*[\s\S]*?\*\//g, '')
    .replace(/(^|[^:])\/\/.*$/gm, '$1');

/**
 * card-share.js 是纯 ESM(无 import) —— 去掉 export 关键字后用 new Function 求值,
 * 直接跑真实逻辑(不复制源码, 避免测试与实现漂移)。
 * uni / getCurrentPages 以参数注入, 天然完成 mock。
 */
function loadCardShare(uni, getCurrentPages) {
    const src = read('common/js/card-share.js').replace(/export\s+(const|function)\s/g, '$1 ');
    const factory = new Function(
        'uni', 'getCurrentPages',
        src + `
        return {
            SHARE_CARD_STORAGE_KEY, SHARE_CARD_MEMORY_TTL,
            rememberShareCardId, takeRememberedShareCardId, pickShareCardId,
            routeQueryValue, appendPathParam, appendQueryParam, pathQueryPart
        };`
    );
    return factory(uni, getCurrentPages);
}

function makeUni() {
    const store = new Map();
    return {
        store,
        setStorageSync(k, v) { store.set(k, v); },
        getStorageSync(k) { return store.has(k) ? store.get(k) : ''; },
        removeStorageSync(k) { store.delete(k); },
    };
}

// =============================================================
//  A. card-share.js 真实行为
// =============================================================

test('A1: 记住 → 取出 往返一致', () => {
    const uni = makeUni();
    const { rememberShareCardId, takeRememberedShareCardId } = loadCardShare(uni, () => []);
    assert.equal(rememberShareCardId('C_1_shop_20261013111612_9588EA'), 'C_1_shop_20261013111612_9588EA');
    assert.equal(takeRememberedShareCardId(), 'C_1_shop_20261013111612_9588EA');
});

test('A2: 取出后即清除(下一次分享不串卡)', () => {
    const uni = makeUni();
    const { rememberShareCardId, takeRememberedShareCardId } = loadCardShare(uni, () => []);
    rememberShareCardId('C_A');
    assert.equal(takeRememberedShareCardId(), 'C_A');
    assert.equal(takeRememberedShareCardId(), '', '第二次取应为空');
});

test('A3: 空 card_id 不入记忆槽', () => {
    const uni = makeUni();
    const { rememberShareCardId, takeRememberedShareCardId } = loadCardShare(uni, () => []);
    assert.equal(rememberShareCardId(''), '');
    assert.equal(rememberShareCardId(null), '');
    assert.equal(takeRememberedShareCardId(), '');
});

test('A4: 记忆过期则不再用于分享(TTL)', () => {
    const uni = makeUni();
    const { rememberShareCardId, takeRememberedShareCardId } = loadCardShare(uni, () => []);
    rememberShareCardId('C_OLD');
    // 把时间戳改老(10 分钟前)
    uni.store.set('_cardShareCardId', { card_id: 'C_OLD', at: Date.now() - 10 * 60 * 1000 });
    assert.equal(takeRememberedShareCardId(), '', '过期记忆应被丢弃');
});

test('A5: pickShareCardId 优先取 dataset(发送给朋友)', () => {
    const uni = makeUni();
    const { rememberShareCardId, pickShareCardId } = loadCardShare(uni, () => []);
    rememberShareCardId('C_FROM_STORAGE');
    const opts = { from: 'button', target: { dataset: { cardId: 'C_FROM_DATASET' } } };
    assert.equal(pickShareCardId(opts), 'C_FROM_DATASET');
});

test('A6: pickShareCardId 无 dataset 时回落 storage(朋友圈通道)', () => {
    const uni = makeUni();
    const { rememberShareCardId, pickShareCardId } = loadCardShare(uni, () => []);
    rememberShareCardId('C_FROM_STORAGE');
    assert.equal(pickShareCardId(null), 'C_FROM_STORAGE');
    // storage 通道是"读一次即清"语义 → 第二次取前需重新记忆
    rememberShareCardId('C_FROM_STORAGE');
    assert.equal(pickShareCardId({ from: 'menu' }), 'C_FROM_STORAGE');
});

test('A6b: 第三级兜底 — storage 空且落地 query 带 card_id → 续传(右上角转发 S5-2)', () => {
    // 场景: 访客经分享落地(query 带 card_id), 未点过任何分享按钮(storage 空),
    // 直接右上角「···」转发 → 应自动续传落地页的源头卡
    const uni = makeUni();
    const { pickShareCardId } = loadCardShare(uni, () => ([{
        route: 'pages_tool/index/diy',
        options: { id: '3', card_id: 'C_LANDING' },
    }]));
    assert.equal(pickShareCardId({ from: 'menu' }), 'C_LANDING');
    assert.equal(pickShareCardId(null), 'C_LANDING');
});

test('A6c: 三级优先级 dataset > storage > 落地 query', () => {
    const uni = makeUni();
    const { rememberShareCardId, pickShareCardId } = loadCardShare(uni, () => ([{
        route: 'pages_tool/index/diy',
        options: { card_id: 'C_LANDING' },
    }]));
    // query 在, 但 dataset 最准 → dataset 胜
    assert.equal(pickShareCardId({ target: { dataset: { cardId: 'C_DATASET' } } }), 'C_DATASET');
    // storage 在(刚点过按钮), dataset 无 → storage 胜(按钮意图更近)
    rememberShareCardId('C_FROM_BTN');
    assert.equal(pickShareCardId(null), 'C_FROM_BTN');
    // 都没有 → 落地 query
    assert.equal(pickShareCardId({ from: 'menu' }), 'C_LANDING');
});

test('A7: pickShareCardId 三路都没有 → 空', () => {
    const uni = makeUni();
    const { pickShareCardId } = loadCardShare(uni, () => []);
    assert.equal(pickShareCardId({ from: 'menu' }), '');
    assert.equal(pickShareCardId(null), '');
});

test('A8: routeQueryValue 从当前页 options 取值(分享落地页)', () => {
    const { routeQueryValue } = loadCardShare(makeUni(), () => ([{
        route: 'pages_tool/index/diy',
        options: { id: '123', name: 'home', card_id: 'C_1_shop_x' },
    }]));
    assert.equal(routeQueryValue('card_id'), 'C_1_shop_x');
    assert.equal(routeQueryValue('id'), '123');
    assert.equal(routeQueryValue('not_exist'), '');
});

test('A9: routeQueryValue 兼容字符串形态 query', () => {
    const { routeQueryValue } = loadCardShare(makeUni(), () => ([{
        route: 'pages_tool/index/diy',
        query: 'id=123&card_id=C_2',
    }]));
    assert.equal(routeQueryValue('card_id'), 'C_2');
});

test('A10: routeQueryValue 无页面 / 无 uni 时安全返回空', () => {
    const { routeQueryValue } = loadCardShare(makeUni(), () => []);
    assert.equal(routeQueryValue('card_id'), '');
});

test('A11: appendPathParam 拼 path(带/不带 query 两种形态)', () => {
    const { appendPathParam } = loadCardShare(makeUni(), () => []);
    assert.equal(
        appendPathParam('/pages_tool/index/diy?id=123', 'card_id', 'C_1'),
        '/pages_tool/index/diy?id=123&card_id=C_1'
    );
    assert.equal(
        appendPathParam('/pages_tool/index/diy', 'card_id', 'C_1'),
        '/pages_tool/index/diy?card_id=C_1'
    );
    assert.equal(appendPathParam('/pages_tool/index/diy?id=1', 'card_id', ''), '/pages_tool/index/diy?id=1');
});

test('A12: appendQueryParam 拼 query(朋友圈只认 query)', () => {
    const { appendQueryParam } = loadCardShare(makeUni(), () => []);
    assert.equal(appendQueryParam('id=123', 'card_id', 'C_1'), 'id=123&card_id=C_1');
    assert.equal(appendQueryParam('', 'card_id', 'C_1'), 'card_id=C_1');
    assert.equal(appendQueryParam('?id=123', 'card_id', 'C_1'), 'id=123&card_id=C_1');
});

test('A13: pathQueryPart 取 path 的 query 段', () => {
    const { pathQueryPart } = loadCardShare(makeUni(), () => []);
    assert.equal(pathQueryPart('/pages_tool/index/diy?id=1&name=x'), 'id=1&name=x');
    assert.equal(pathQueryPart('/pages_tool/index/diy'), '');
});

// =============================================================
//  B. DIY 页分享钩子(common/js/diy.js)
// =============================================================

/**
 * 把 diy.js 的两个分享钩子抠出来**真跑**(diy.js 本体 import 了地图/配置等模块,
 * node 里无法直接 import; 这里只抠钩子源码, 用 card-share.js 的真实实现注入)。
 */
function loadDiyShareHooks() {
    const src = read('common/js/diy.js');
    const start = src.indexOf('onShareAppMessage(options) {');
    // 两个钩子是文件最后两个方法 → 一直取到导出对象的最后一个 '}' 之前
    const end = src.lastIndexOf('}');
    assert.ok(start > 0 && end > start, '未能定位 diy.js 的分享钩子');
    const hooksSrc = src.slice(start, end);
    const share = loadCardShare(makeUni(), () => []);
    const factory = new Function(
        'pickShareCardId', 'appendPathParam', 'appendQueryParam', 'pathQueryPart',
        'return {' + hooksSrc + '};'
    );
    const hooks = factory(share.pickShareCardId, share.appendPathParam, share.appendQueryParam, share.pathQueryPart);
    return { hooks, share };
}

/** 模拟一个 DIY 页实例的上下文 */
function makeDiyCtx() {
    return {
        mpShareData: {
            appMessage: { title: '店铺名', path: '/pages_tool/index/diy?id=3', imageUrl: 'cover.png' },
            timeLine: { title: '店铺名', query: '/pages_tool/index/diy?id=3', imageUrl: 'cover.png' },
        },
        $util: {
            getCurrentRoute: () => ({ path: '/pages_tool/index/diy?id=3&name=home', query: 'id=3&name=home' }),
        },
    };
}

test('B1: diy.js 引入名片分享工具', () => {
    const src = read('common/js/diy.js');
    assert.match(src, /import\s*\{[^}]*pickShareCardId[^}]*\}\s*from\s*['"]@\/common\/js\/card-share\.js['"]/,
        '未引入 card-share.js 的 pickShareCardId');
});

test('B2: onShareAppMessage 接 options 并按 dataset/storage 取 card_id', () => {
    const src = strip(read('common/js/diy.js'));
    assert.match(src, /onShareAppMessage\(options\)\s*\{/,
        'onShareAppMessage 未接事件参数(拿不到 dataset)');
    assert.match(src, /pickShareCardId\(options\)/,
        'onShareAppMessage 未从事件里取 card_id');
});

test('B3: onShareAppMessage 把 card_id 拼进分享 path', () => {
    const src = strip(read('common/js/diy.js'));
    assert.match(src, /appendPathParam\([^)]*'card_id',\s*cardId\)/,
        '分享 path 未追加 card_id');
});

test('B4: onShareTimeline 走 storage 通道并把 card_id 拼进 query', () => {
    const src = strip(read('common/js/diy.js'));
    assert.match(src, /onShareTimeline\(\)\s*\{/);
    assert.match(src, /pickShareCardId\(null\)/,
        'onShareTimeline 未从 storage 取 card_id(它不接受事件参数)');
    assert.match(src, /appendQueryParam\([^)]*'card_id',\s*cardId\)/,
        '朋友圈 query 未追加 card_id');
});

test('B5: 拿不到 card_id 时仍回落原分享数据(向后兼容)', () => {
    const src = strip(read('common/js/diy.js'));
    assert.match(src, /return this\.mpShareData\?\.appMessage;/,
        '未保留原有 appMessage 回落');
    assert.match(src, /return base;/,
        '未保留原有 timeLine 回落');
});

test('B6: 行为级 — 钩子真跑: dataset 命中 → path 带 card_id', () => {
    const { hooks, share } = loadDiyShareHooks();
    const ctx = makeDiyCtx();
    const res = hooks.onShareAppMessage.call(ctx, {
        from: 'button',
        target: { dataset: { cardId: 'C_1_shop_x', cardName: '张三' } },
    });
    assert.equal(res.path, '/pages_tool/index/diy?id=3&name=home&card_id=C_1_shop_x',
        '分享 path 未带上当前页 query + card_id');
    assert.equal(res.title, '店铺名');
});

test('B7: 行为级 — 无 card_id 时原样返回后台配置的分享数据', () => {
    const { hooks } = loadDiyShareHooks();
    const ctx = makeDiyCtx();
    assert.equal(hooks.onShareAppMessage.call(ctx, { from: 'menu' }), ctx.mpShareData.appMessage,
        '无 card_id 时应原样返回 mpShareData.appMessage');
});

test('B8: 行为级 — 朋友圈钩子把 card_id 拼进 query', () => {
    const { hooks, share } = loadDiyShareHooks();
    const ctx = makeDiyCtx();
    share.rememberShareCardId('C_1_shop_x');
    const res = hooks.onShareTimeline.call(ctx);
    assert.equal(res.query, 'id=3&card_id=C_1_shop_x',
        '朋友圈 query 未带 card_id');
    assert.equal(res.title, '店铺名');
});

test('B9: 行为级 — 朋友圈无 card_id 时原样回落', () => {
    const { hooks } = loadDiyShareHooks();
    const ctx = makeDiyCtx();
    assert.equal(hooks.onShareTimeline.call(ctx), ctx.mpShareData.timeLine);
});

// =============================================================
//  B+. H5 公众号分享链接补 card_id(setPublicShare, S10-1)
// =============================================================

/** 把 diy.js 的 setPublicShare 抠出来真跑(同 loadDiyShareHooks 思路) */
function loadDiySetPublicShare(share) {
    const src = read('common/js/diy.js');
    const start = src.indexOf('setPublicShare() {');
    const end = src.indexOf('onPageScroll(e) {');
    assert.ok(start > 0 && end > start, '未能定位 diy.js 的 setPublicShare');
    // 剥注释后, 丢掉切片尾部的外层 methods 闭括号(setPublicShare 自己的 '}' 是倒数第二个)
    let body = strip(src.slice(start, end));
    body = body.slice(0, body.lastIndexOf('}')).trim();
    const factory = new Function('routeQueryValue', 'appendPathParam', 'return {' + body + '};');
    // 工厂返回 { setPublicShare: fn } 对象, 这里直接交出方法本体
    return factory(share.routeQueryValue, share.appendPathParam).setPublicShare;
}

test('B10: diy.js 引入 routeQueryValue 且 setPublicShare 补 card_id', () => {
    const src = read('common/js/diy.js');
    assert.match(src, /import\s*\{[^}]*routeQueryValue[^}]*\}\s*from\s*['"]@\/common\/js\/card-share\.js['"]/,
        '未引入 card-share.js 的 routeQueryValue');
    const stripped = strip(src);
    const start = stripped.indexOf('setPublicShare()');
    const end = stripped.indexOf('onPageScroll');
    assert.ok(start > 0 && end > start, '未定位到 setPublicShare');
    const seg = stripped.slice(start, end);
    assert.match(seg, /routeQueryValue\('card_id'\)/, 'setPublicShare 未从落地 query 取 card_id');
    assert.match(seg, /appendPathParam\(shareUrl, 'card_id', shareCardId\)/, '分享链接未追加 card_id');
});

test('B11: 行为级 — H5 落地带 card_id 时公众号分享链接续传', () => {
    const uni = makeUni();
    const share = loadCardShare(uni, () => ([{
        route: 'pages_tool/index/diy',
        options: { id: '3', card_id: 'C_1_shop_x' },
    }]));
    const setPublicShare = loadDiySetPublicShare(share);
    let captured = null;
    const ctx = {
        $config: { h5Domain: 'https://h5.example.com' },
        diyRoute: '/pages_tool/index/diy',
        id: 3,
        name: '',
        $util: { setPublicShare: d => { captured = d; }, img: s => s || '' },
        $langConfig: { getField: () => '标题' },
        diyData: { global: {} },
        siteInfo: null,
    };
    setPublicShare.call(ctx);
    assert.equal(captured.link, 'https://h5.example.com/pages_tool/index/diy?id=3&card_id=C_1_shop_x',
        'H5 分享链接未续传落地 card_id');
});

test('B12: 行为级 — 裸 Tab(无 card_id)时 H5 分享链接行为零变化', () => {
    const uni = makeUni();
    const share = loadCardShare(uni, () => ([]));
    const setPublicShare = loadDiySetPublicShare(share);
    let captured = null;
    const ctx = {
        $config: { h5Domain: 'https://h5.example.com' },
        diyRoute: '/pages_tool/index/diy',
        id: 3,
        name: '',
        $util: { setPublicShare: d => { captured = d; }, img: s => s || '' },
        $langConfig: { getField: () => '标题' },
        diyData: { global: {} },
        siteInfo: null,
    };
    setPublicShare.call(ctx);
    assert.equal(captured.link, 'https://h5.example.com/pages_tool/index/diy?id=3',
        '无 card_id 时链接应保持原样(不得追加空参数)');
});

// =============================================================
//  C. 名片基件的分享按钮(diy-card-mini.vue)
// =============================================================

test('C1: 小程序端分享按钮带 data-card-id + @tap 记忆', () => {
    const src = strip(read('components-diy/diy-card-mini.vue'));
    assert.match(src, /open-type="share"/, '分享按钮丢了 open-type=share');
    assert.match(src, /:data-card-id="card && card\.card_id"/,
        '分享按钮未带 data-card-id(dataset 通道依赖它)');
    assert.match(src, /@tap="rememberShareCard"/,
        '分享按钮未在 tap 时记住卡片(storage 通道依赖它)');
});

test('C2: diy-card-mini 引入 rememberShareCardId 并实现 rememberShareCard', () => {
    const src = read('components-diy/diy-card-mini.vue');
    assert.match(src, /import\s*\{[^}]*rememberShareCardId[^}]*\}\s*from\s*['"]@\/common\/js\/card-share\.js['"]/);
    assert.match(src, /rememberShareCard\(\)\s*\{[\s\S]*?rememberShareCardId\(this\.card && this\.card\.card_id\)/);
});

// =============================================================
//  D. 「我的名片」组件把分享带来的 card_id 回传后端(diy-card-self.vue)
// =============================================================

test('D1: diy-card-self 从路由 query 取 card_id 并传给 mycard', () => {
    const src = strip(read('components-diy/diy-card-self.vue'));
    assert.match(src, /routeQueryValue\('card_id'\)/,
        '未从路由 query 取分享带来的 card_id');
    assert.match(src, /card_id:\s*shareCardId/,
        '请求参数未带 card_id');
});

test('D2: 分享卡优先于登录引导空态(fallbackMode=none 也照常取分享卡)', () => {
    const src = strip(read('components-diy/diy-card-self.vue'));
    assert.match(src, /!this\.hasToken && this\.fallbackMode === 'none' && !shareCardId/,
        '登录引导早退条件未排除"有分享卡"的情况');
});

// =============================================================
//  E. 全局兜底 mixin 的 dataset 分支仍在(其它页面继续受益)
// =============================================================

test('E1: mp-share-default 的 dataset.cardId 分支未被破坏', () => {
    const src = strip(read('common/js/mp-share-default.js'));
    assert.match(src, /options\.target\.dataset\.cardId/,
        '全局兜底 mixin 的 dataset 分支丢了');
    assert.match(src, /path:\s*'\/pages_tool\/card\/detail\?card_id=' \+ d\.cardId/);
});