koishi-plugin-rocom 1.0.17 → 1.0.19

package/lib/merchant-clock.d.ts

@@ -0,0 +1,22 @@
+export interface ClockParts {
+    date: string;
+    hour: number;
+    minute: number;
+    second: number;
+}
+export declare class MerchantClock {
+    private formatter;
+    private fixedOffset;
+    readonly zone: string;
+    constructor(requested?: string);
+    parts(nowMs?: number): ClockParts;
+    date(nowMs?: number): string;
+    /** Boundaries in absolute time, including 23/25-hour DST days. */
+    dayBounds(nowMs?: number): {
+        start: number;
+        end: number;
+    };
+    minuteOfDay(nowMs?: number): number;
+    timeText(nowMs?: number): string;
+    nextTimeFor(times: string[], nowMs?: number): number | null;
+}

package/lib/merchant-clock.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MerchantClock = void 0;
+function pad(value, width = 2) {
+    return String(value).padStart(width, '0');
+}
+// 统一时钟：默认上海时区失败时固定 +08:00，避免 UTC 服务器上商品日期/轮次错位。
+class MerchantClock {
+    formatter;
+    fixedOffset = false;
+    zone;
+    constructor(requested = 'Asia/Shanghai') {
+        const wanted = requested || 'Asia/Shanghai';
+        let zone = wanted;
+        try {
+            new Intl.DateTimeFormat('en-CA', { timeZone: zone }).format(0);
+        }
+        catch {
+            if (wanted === 'Asia/Shanghai') {
+                zone = 'UTC';
+                this.fixedOffset = true;
+            }
+            else {
+                zone = Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+            }
+        }
+        this.zone = this.fixedOffset ? 'UTC+08:00' : zone;
+        this.formatter = new Intl.DateTimeFormat('en-CA', {
+            timeZone: zone,
+            hourCycle: 'h23',
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+        });
+    }
+    parts(nowMs = Date.now()) {
+        const timestamp = nowMs + (this.fixedOffset ? 8 * 3600_000 : 0);
+        const values = {};
+        for (const part of this.formatter.formatToParts(timestamp)) {
+            if (part.type !== 'literal')
+                values[part.type] = part.value;
+        }
+        return {
+            date: `${values.year}-${values.month}-${values.day}`,
+            hour: Number(values.hour),
+            minute: Number(values.minute),
+            second: Number(values.second),
+        };
+    }
+    date(nowMs = Date.now()) {
+        return this.parts(nowMs).date;
+    }
+    /** Boundaries in absolute time, including 23/25-hour DST days. */
+    dayBounds(nowMs = Date.now()) {
+        const day = this.date(nowMs);
+        const edge = (before) => {
+            let low = before ? nowMs - 48 * 3600_000 : nowMs;
+            let high = before ? nowMs : nowMs + 48 * 3600_000;
+            while (high - low > 1) {
+                const mid = Math.floor((low + high) / 2);
+                if (before ? this.date(mid) < day : this.date(mid) === day)
+                    low = mid;
+                else
+                    high = mid;
+            }
+            return high;
+        };
+        return { start: edge(true), end: edge(false) };
+    }
+    minuteOfDay(nowMs = Date.now()) {
+        const p = this.parts(nowMs);
+        return p.hour * 60 + p.minute;
+    }
+    timeText(nowMs = Date.now()) {
+        const p = this.parts(nowMs);
+        return `${pad(p.hour)}:${pad(p.minute)}`;
+    }
+    // 下一个匹配给定 HH:MM 墙钟列表的时刻（毫秒），扫描精度 1 分钟。
+    nextTimeFor(times, nowMs = Date.now()) {
+        const targets = new Set(times.map(item => String(item || '').trim()).filter(Boolean));
+        if (!targets.size)
+            return null;
+        let cursor = Math.floor(nowMs / 60000) * 60000 + 60000;
+        for (let i = 0; i < 60 * 24 * 8; i++) {
+            if (targets.has(this.timeText(cursor)))
+                return cursor;
+            cursor += 60000;
+        }
+        return null;
+    }
+}
+exports.MerchantClock = MerchantClock;

package/lib/merchant-service.d.ts

@@ -0,0 +1,24 @@
+export interface MerchantItem {
+    id: string;
+    parentId?: string;
+    name: string;
+    icon: string;
+    price: number | null;
+    limit: number | null;
+    startsAt: number | null;
+    endsAt: number | null;
+    active: boolean;
+    category: string;
+    source: 'live' | 'legacy';
+}
+export interface NormalizedMerchant {
+    source: 'live' | 'legacy';
+    items: MerchantItem[];
+}
+export declare const numberOrNull: (v: unknown) => number | null;
+export declare function livePrice(value: any): number | null;
+export declare function merchantTimestampMs(value: any): number | null;
+export declare function normalizeLiveMerchant(payload: any, nowMs?: number): MerchantItem[];
+export declare function normalizeLegacyMerchant(payload: any, nowMs?: number): MerchantItem[];
+export declare function isLiveMerchantPayload(payload: any): boolean;
+export declare function normalizeMerchant(payload: any, nowMs?: number): NormalizedMerchant;

package/lib/merchant-service.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.numberOrNull = void 0;
+exports.livePrice = livePrice;
+exports.merchantTimestampMs = merchantTimestampMs;
+exports.normalizeLiveMerchant = normalizeLiveMerchant;
+exports.normalizeLegacyMerchant = normalizeLegacyMerchant;
+exports.isLiveMerchantPayload = isLiveMerchantPayload;
+exports.normalizeMerchant = normalizeMerchant;
+const client_1 = require("./client");
+const numberOrNull = (v) => {
+    if (v === undefined || v === null || v === '')
+        return null;
+    const n = Number(v);
+    return Number.isFinite(n) ? n : null;
+};
+exports.numberOrNull = numberOrNull;
+// 价格可能直接是数字，也可能是 { real, origin } 或 { amount }（上游 v4.1.0）。
+function livePrice(value) {
+    const selected = value && typeof value === 'object'
+        ? value.real ?? value.origin : value;
+    return (0, exports.numberOrNull)(selected && typeof selected === 'object'
+        ? selected.amount : selected);
+}
+// 秒/毫秒时间戳统一为毫秒；0/空值视为无时间。
+function merchantTimestampMs(value) {
+    if (value === null || value === undefined || value === '' || value === 0 || value === '0')
+        return null;
+    const timestamp = Number(value);
+    if (!Number.isFinite(timestamp))
+        return null;
+    return Math.abs(timestamp) < 100_000_000_000 ? timestamp * 1000 : timestamp;
+}
+function mappingById(payload) {
+    const mapping = payload?._goods_mapping ?? payload?.goods_mapping;
+    const list = Array.isArray(mapping) ? mapping : [];
+    const map = new Map();
+    for (const item of list) {
+        if ((0, client_1.isObject)(item) && item.goods_id !== undefined && item.goods_id !== null) {
+            map.set(String(item.goods_id), item);
+        }
+    }
+    return map;
+}
+function liveGoodsName(meta, item, goodsId) {
+    const name = String(meta?.goods_name || meta?.name || item?.name || item?.goods_name || '').trim();
+    if (name)
+        return name;
+    return goodsId !== undefined && goodsId !== null && goodsId !== '' ? `商品 ${goodsId}` : '未知商品';
+}
+function liveGoodsIcon(meta, item) {
+    return String(item?.icon_url || item?.iconUrl || meta?.icon_url || meta?.icon || '').trim();
+}
+// 实时商人 goods 结构：按 mapping 补齐名称/图标，递归 sub_goods，按“商品 ID + 时间窗口 + 父商品”去重。
+function normalizeLiveMerchant(payload, nowMs = Date.now()) {
+    const map = mappingById(payload);
+    const items = [];
+    const seen = new Set();
+    const add = (raw, parentId) => {
+        if (!(0, client_1.isObject)(raw))
+            return;
+        const goodsId = raw.goods_id ?? raw.id;
+        const meta = map.get(String(goodsId)) || {};
+        const startsAt = merchantTimestampMs(raw.start_time ?? payload?.start_time);
+        const endsAt = merchantTimestampMs(raw.disable_time ?? raw.end_time);
+        const key = `${String(goodsId)}|${startsAt ?? ''}|${endsAt ?? ''}|${parentId ?? ''}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        items.push({
+            id: String(goodsId ?? ''),
+            parentId,
+            name: liveGoodsName(meta, raw, goodsId),
+            icon: liveGoodsIcon(meta, raw),
+            price: livePrice(raw.price) ?? (0, exports.numberOrNull)(meta.price),
+            limit: (0, exports.numberOrNull)(raw.limit_buy_num ?? raw.buy_limit_num ?? meta.buy_limit_num),
+            startsAt,
+            endsAt,
+            active: (startsAt === null || nowMs >= startsAt) && (endsAt === null || nowMs < endsAt),
+            category: parentId ? '子商品' : '商品',
+            source: 'live',
+        });
+        const children = Array.isArray(raw.sub_goods) ? raw.sub_goods : [];
+        for (const child of children)
+            add(child, String(goodsId ?? ''));
+    };
+    const goods = Array.isArray(payload?.goods) ? payload.goods : [];
+    for (const raw of goods)
+        add(raw);
+    return items;
+}
+// 旧接口：merchantActivities 下 products/get_props/get_extra_props/get_pets 合并，random_goods 补价格/限购。
+function normalizeLegacyMerchant(payload, nowMs = Date.now()) {
+    const activities = payload?.merchantActivities || payload?.merchant_activities || [];
+    const activity = activities[0] || {};
+    const randomGoods = Array.isArray(payload?.random_goods) ? payload.random_goods : [];
+    const metaByName = new Map();
+    for (const item of randomGoods) {
+        const name = String(item?.goods_name || item?.name || '').trim();
+        if (name)
+            metaByName.set(name, item);
+    }
+    const buckets = [
+        ['道具', activity.get_props || []],
+        ['额外道具', activity.get_extra_props || []],
+        ['精灵', activity.get_pets || []],
+        ['商品', activity.products || []],
+        ['商品', activity.product_list || []],
+    ];
+    const items = [];
+    const seen = new Set();
+    for (const [category, list] of buckets) {
+        for (const raw of Array.isArray(list) ? list : []) {
+            if (!(0, client_1.isObject)(raw))
+                continue;
+            const name = String(raw.name || raw.goods_name || '未知商品').trim() || '未知商品';
+            const startsAt = merchantTimestampMs(raw.start_time) ?? merchantTimestampMs(activity.start_time);
+            const endsAt = merchantTimestampMs(raw.end_time) ?? merchantTimestampMs(activity.end_time);
+            const key = `${raw.id ?? ''}|${name}|${startsAt ?? 0}|${endsAt ?? 'inf'}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            const meta = metaByName.get(name) || {};
+            items.push({
+                id: String(raw.id ?? ''),
+                name,
+                icon: String(raw.icon_url || raw.iconUrl || meta.icon_url || meta.icon || '').trim(),
+                price: (0, exports.numberOrNull)(raw.price) ?? (0, exports.numberOrNull)(meta.price),
+                limit: (0, exports.numberOrNull)(raw.buy_limit_num ?? raw.limit_buy_num) ?? (0, exports.numberOrNull)(meta.buy_limit_num),
+                startsAt,
+                endsAt,
+                active: (startsAt === null || nowMs >= startsAt) && (endsAt === null || nowMs < endsAt),
+                category,
+                source: 'legacy',
+            });
+        }
+    }
+    return items;
+}
+function isLiveMerchantPayload(payload) {
+    return (0, client_1.isObject)(payload) && Array.isArray(payload.goods);
+}
+function normalizeMerchant(payload, nowMs = Date.now()) {
+    if (isLiveMerchantPayload(payload)) {
+        return { source: 'live', items: normalizeLiveMerchant(payload, nowMs) };
+    }
+    return { source: 'legacy', items: normalizeLegacyMerchant(payload, nowMs) };
+}

package/lib/permissions.d.ts

@@ -0,0 +1,16 @@
+import type { PluginConfig } from './types';
+export type GroupRole = 'owner' | 'admin' | 'member' | 'unknown';
+export interface SubscriptionPermissionInput {
+    privateChat: boolean;
+    privateAllowed: boolean;
+    groupRole: GroupRole;
+    groupAdminEnabled: boolean;
+    botAdminEnabled: boolean;
+    whitelisted: boolean;
+    authority: number;
+    botAdminAuthority: number;
+}
+export declare function mayManageSubscription(p: SubscriptionPermissionInput): boolean;
+export declare function groupRoleFromSession(session: any): GroupRole;
+export declare function isDirectSession(session: any): boolean;
+export declare function canManageSubscription(config: PluginConfig, session: any, privateAllowed?: boolean): boolean;

package/lib/permissions.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mayManageSubscription = mayManageSubscription;
+exports.groupRoleFromSession = groupRoleFromSession;
+exports.isDirectSession = isDirectSession;
+exports.canManageSubscription = canManageSubscription;
+// 统一订阅权限策略：群主/管理员与 Bot 管理员按独立开关生效。
+function mayManageSubscription(p) {
+    if (p.privateChat)
+        return p.privateAllowed;
+    if (p.botAdminEnabled && (p.whitelisted || p.authority >= p.botAdminAuthority))
+        return true;
+    return p.groupAdminEnabled && (p.groupRole === 'owner' || p.groupRole === 'admin');
+}
+// 从平台会话中读取可信角色；只接受适配器规范化的字符串角色。
+function groupRoleFromSession(session) {
+    const collect = (value, output) => {
+        if (value === undefined || value === null)
+            return;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                collect(item, output);
+            return;
+        }
+        output.push(String(value));
+    };
+    const roles = [];
+    const member = session?.event?.member || session?.member;
+    collect(member?.roles, roles);
+    collect(member?.role, roles);
+    const sender = session?.event?.sender || session?.sender;
+    collect(sender?.role, roles);
+    const author = session?.event?.author || session?.author;
+    collect(author?.member_role, roles);
+    collect(author?.memberRole, roles);
+    collect(member?.member_role, roles);
+    // OneBot 原始事件由适配器提供；不从消息正文读取角色。
+    collect(session?.onebot?.sender?.role, roles);
+    const normalized = roles.map(role => role.trim().toLowerCase());
+    if (normalized.some(role => ['owner', '群主', '创建者'].includes(role)))
+        return 'owner';
+    if (normalized.some(role => ['admin', 'administrator', '管理员'].includes(role)))
+        return 'admin';
+    if (normalized.some(role => ['member', '普通成员'].includes(role)))
+        return 'member';
+    return 'unknown';
+}
+function isDirectSession(session) {
+    if (typeof session?.isDirect === 'boolean')
+        return session.isDirect;
+    const type = session?.event?.channel?.type;
+    if (type !== undefined)
+        return type === 1 || type === 'DIRECT';
+    return !session?.guildId;
+}
+function canManageSubscription(config, session, privateAllowed = true) {
+    return mayManageSubscription({
+        privateChat: isDirectSession(session), privateAllowed,
+        groupRole: groupRoleFromSession(session),
+        groupAdminEnabled: config.subscriptionGroupAdminEnabled !== false,
+        botAdminEnabled: config.subscriptionBotAdminEnabled !== false,
+        whitelisted: config.adminUserIds.includes(session?.userId || ''),
+        authority: Number(session?.user?.authority ?? 0) || 0,
+        botAdminAuthority: Math.max(1, Number(config.subscriptionBotAdminAuthority) || 4),
+    });
+}

package/lib/pet-data-service.js

@@ -24,6 +24,7 @@ exports.petDataSkills = petDataSkills;
 exports.petDataCardItems = petDataCardItems;
 exports.petDataExtractItems = petDataExtractItems;
 exports.buildPetDataRenderData = buildPetDataRenderData;
+const pet_size_1 = require("./pet-size");
 const CN_TIME_ZONE = 'Asia/Shanghai';
 function petDataDisplay(value, defaultText = '--') {
     if (value === undefined || value === null || value === '')
@@ -105,12 +106,14 @@ function petDataKgCompact(grams) {
     const text = (number / 1000).toFixed(2).replace(/0+$/, '').replace(/\.$/, '');
     return `${text}kg`;
 }
-// 上游 v3.7.0：接入 Wiki 精灵体重范围，前 5% 标小块头、后 5% 标大块头。
+// 上游 v3.7.0：接入 Wiki 精灵体重范围，与查蛋共用同一判定。
 function petDataWeightSizeInfo(pet, wikiPet) {
     const bodySize = wikiPet && typeof wikiPet === 'object' ? wikiPet.body_size : null;
     const weightRange = bodySize && typeof bodySize === 'object' ? bodySize.weight : null;
     if (!weightRange || typeof weightRange !== 'object')
         return {};
+    if ([pet?.weight, weightRange.min_g, weightRange.max_g].some(value => value == null || value === ''))
+        return {};
     const current = Number(pet?.weight);
     const low = Number(weightRange.min_g);
     const high = Number(weightRange.max_g);
@@ -118,15 +121,10 @@ function petDataWeightSizeInfo(pet, wikiPet) {
         return {};
     if (high <= low)
         return {};
-    const span = high - low;
-    const smallCut = low + span * 0.05;
-    const largeCut = high - span * 0.05;
+    const size = (0, pet_size_1.classifyWeight)(current / 1000, low / 1000, high / 1000);
     const rangeText = `${petDataKgCompact(low)}-${petDataKgCompact(high)}`;
-    if (current <= smallCut) {
-        return { label: '小块头', className: 'size-small', hint: `小块头 · ≤${petDataKgCompact(smallCut)} · 范围 ${rangeText}` };
-    }
-    if (current >= largeCut) {
-        return { label: '大块头', className: 'size-large', hint: `大块头 · ≥${petDataKgCompact(largeCut)} · 范围 ${rangeText}` };
+    if (size) {
+        return { label: size.label, className: size.css, hint: `${size.label} · ${size.css === 'size-small' ? '≤' : '≥'}${petDataKgCompact(size.threshold * 1000)} · 范围 ${rangeText}` };
     }
     return { label: '', className: '', hint: `范围 ${rangeText}` };
 }

package/lib/pet-size.d.ts

@@ -0,0 +1,13 @@
+export interface WeightClass {
+    label: '小块头' | '大块头';
+    css: 'size-small' | 'size-large';
+    threshold: number;
+}
+export declare function classifyWeight(weightKg: number, minKg: number, maxKg: number): WeightClass | null;
+export interface SizeVariant {
+    size_variant: string;
+    size_variant_label: string;
+    size_variant_class: string;
+    size_variant_hint: string;
+}
+export declare function sizeVariantPayload(queryWeight: unknown, minKg: unknown, maxKg: unknown, rangeText?: string): SizeVariant;

package/lib/pet-size.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyWeight = classifyWeight;
+exports.sizeVariantPayload = sizeVariantPayload;
+// 体重范围下端 5% / 上端 5% 判定大小块头；使用未四舍五入的数值比较。
+function classifyWeight(weightKg, minKg, maxKg) {
+    if (![weightKg, minKg, maxKg].every(Number.isFinite) || maxKg <= minKg)
+        return null;
+    if (weightKg < minKg || weightKg > maxKg)
+        return null;
+    const span = maxKg - minKg;
+    const small = minKg + span * 0.05;
+    const large = maxKg - span * 0.05;
+    if (weightKg <= small)
+        return { label: '小块头', css: 'size-small', threshold: small };
+    if (weightKg >= large)
+        return { label: '大块头', css: 'size-large', threshold: large };
+    return null;
+}
+function num(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function formatNumber(value, digits = 3) {
+    return String(Number(value.toFixed(digits)));
+}
+const EMPTY_VARIANT = {
+    size_variant: '',
+    size_variant_label: '',
+    size_variant_class: '',
+    size_variant_hint: '',
+};
+function sizeVariantPayload(queryWeight, minKg, maxKg, rangeText = '') {
+    const query = num(queryWeight);
+    const low = num(minKg);
+    const high = num(maxKg);
+    if (query === null || low === null || high === null || high <= low)
+        return EMPTY_VARIANT;
+    const cls = classifyWeight(query, low, high);
+    if (!cls)
+        return EMPTY_VARIANT;
+    const limit = formatNumber(cls.threshold);
+    const range = rangeText || `${formatNumber(low)}-${formatNumber(high)}kg`;
+    return {
+        size_variant: cls.css === 'size-small' ? 'small' : 'large',
+        size_variant_label: cls.label,
+        size_variant_class: cls.css,
+        size_variant_hint: cls.label === '小块头'
+            ? `小块头区间：≤ ${limit} kg（体重范围 ${range} 的前 5%）`
+            : `大块头区间：≥ ${limit} kg（体重范围 ${range} 的后 5%）`,
+    };
+}

package/lib/player-service.d.ts

@@ -0,0 +1,37 @@
+export interface PlayerRow {
+    field?: string;
+    label?: string;
+    value?: unknown;
+}
+export type IngamePlayerPayload = {
+    rows?: PlayerRow[];
+    notes?: unknown[];
+    title?: string;
+    player_info?: Record<string, any>;
+    player_card_brief_info?: Record<string, any>;
+    [key: string]: any;
+};
+export declare function resourceUrl(value: unknown, apiBaseUrl: string): string;
+export declare function playerRows(payload: any, uid: string): PlayerRow[];
+/** 玩家时间统一按北京时间展示，不依赖 Bot 所在服务器的时区。 */
+export declare function formatPlayerTime(value: unknown): string;
+export declare function cleanPlayerFieldValue(field: string, value: unknown): string;
+export interface ParsedPlayer {
+    title: string;
+    nickname: string;
+    uid: string;
+    level: string;
+    signature: string;
+    rowMap: Record<string, string>;
+    labelMap: Record<string, string>;
+}
+export declare function parseIngamePlayerPayload(payload: IngamePlayerPayload | null | undefined, uid: string): ParsedPlayer;
+export declare function playerField(parsed: ParsedPlayer | null, field: string, defaultValue?: string): string;
+export interface PlayerView {
+    parsed: ParsedPlayer;
+    cardImageUrl: string;
+}
+export declare function buildPlayerView(searchPayload: any, cardPayload: any, uid: string, apiBaseUrl: string): PlayerView;
+export declare function mergePlayerPayloads(searchPayload: any, cardPayload: any): any;
+export declare function playerPayloadUid(payload: any): string;
+export declare function buildPlayerText(payload: any, uid: string): string;