koishi-plugin-noah 1.0.0

package/lib/config.d.ts

@@ -0,0 +1,2 @@
+import { AppConfig } from './types/config';
+export declare const Config: AppConfig;

package/lib/core/command.d.ts

@@ -0,0 +1,4 @@
+import { Context } from "koishi";
+import { CoreConfig } from "../types/config";
+export declare const name = "command";
+export declare function apply(ctx: Context, config: CoreConfig): void;

package/lib/core/commands/bind.d.ts

@@ -0,0 +1,3 @@
+import { Context } from 'koishi';
+import { CoreConfig } from '../../types/config';
+export declare function bind(ctx: Context, config: CoreConfig): void;

package/lib/core/commands/card.d.ts

@@ -0,0 +1,3 @@
+import { Context } from 'koishi';
+import { CoreConfig } from '../../types/config';
+export declare function card(ctx: Context, config: CoreConfig): void;

package/lib/core/commands/help.d.ts

@@ -0,0 +1,3 @@
+import { Context } from 'koishi';
+import { CoreConfig } from '../../types/config';
+export declare function help(ctx: Context, config: CoreConfig): void;

package/lib/core/commands/server.d.ts

@@ -0,0 +1,3 @@
+import { Context } from 'koishi';
+import { CoreConfig } from '../../types/config';
+export declare function server(ctx: Context, config: CoreConfig): void;

package/lib/core/config.d.ts

@@ -0,0 +1,2 @@
+import { CoreConfig } from '../types/config';
+export declare const coreConfig: CoreConfig;

package/lib/core/database.d.ts

@@ -0,0 +1,49 @@
+import { Context } from "koishi";
+import { TGame, TServer } from "../types";
+declare module 'koishi' {
+    interface Tables {
+        card: Card;
+        server: Server;
+        user_card: UserCard;
+        user_server: UserServer;
+        channel_server: ChannelServer;
+    }
+    interface User {
+        defaultCardId: number;
+        defaultServerId: number;
+    }
+    interface Channel {
+        defaultServerId: number;
+    }
+}
+export interface Card {
+    id: number;
+    code: string;
+    name: string;
+    defaultServerId?: number;
+}
+export interface Server {
+    id: number;
+    type: TServer;
+    name: string;
+    baseUrl: string;
+    pcbid?: string;
+    supportedGames: TGame[];
+}
+export interface UserCard {
+    id: number;
+    uid: number;
+    cid: number;
+}
+export interface UserServer {
+    id: number;
+    uid: number;
+    sid: number;
+}
+export interface ChannelServer {
+    id: number;
+    cid: string;
+    sid: number;
+}
+export declare const name = "database";
+export declare function apply(ctx: Context): void;

package/lib/core/index.d.ts

@@ -0,0 +1,6 @@
+import { Context, Logger } from "koishi";
+import type { AppConfig } from "../types/config";
+export declare const name = "Noah-Core";
+export declare const inject: string[];
+export declare const logger: Logger;
+export declare function apply(ctx: Context, config: AppConfig): void;

package/lib/core/services/card-service.d.ts

@@ -0,0 +1,46 @@
+import { Context } from 'koishi';
+import { Card } from '../types';
+export declare class CardService {
+    private ctx;
+    private readonly tableName;
+    constructor(ctx: Context);
+    /**
+     * 获取所有卡片列表
+     */
+    getAllCards(): Promise<Card[]>;
+    /**
+     * 根据 user id 获取卡片列表
+     * @param uid 用户的 user id
+     * @returns 该用户绑定的卡片的完整信息列表
+     */
+    getCardsByUid(uid: number): Promise<Card[]>;
+    /**
+     * 根据 id 获取卡片信息
+     */
+    getCardById(id: number): Promise<Card | null>;
+    /**
+     * 根据 code 获取卡片信息
+     */
+    getCardByCode(code: string): Promise<Card | null>;
+    /**
+     * 创建一张新的卡
+     * @param uid 用户的 uid
+     * @param code 卡片的卡号
+     * @param name 卡片的名称
+     * @param defaultServerId 默认服务器 ID（若没有默认服务器则为 0）
+     * @returns 创建成功后包含自动填充 id 等字段的完整对象
+     */
+    createCard(uid: number, code: string, name: string, defaultServerId?: number): Promise<Card>;
+    /**
+     * 更新卡片的信息
+     * - 可更新 code、name、defaultServerId
+     * @param id 卡片的 id
+     * @param partial 更新字段
+     */
+    updateCard(id: number, partial: Partial<Omit<Card, 'id'>>): Promise<void>;
+    /**
+     * 删除卡片
+     * @param id 卡片 id
+     */
+    removeCard(id: number): Promise<void>;
+}

package/lib/core/services/server-service.d.ts

@@ -0,0 +1,61 @@
+import { Context } from 'koishi';
+import { TServer } from "../../types";
+import { Server } from '../types';
+export declare class ServerService {
+    private ctx;
+    private readonly tableName;
+    constructor(ctx: Context);
+    /**
+     * 获取所有服务器列表
+     */
+    getAllServers(): Promise<Server[]>;
+    /**
+     * 根据 user id 获取服务器列表
+     * @param uid 用户的 user id
+     * @returns 该用户绑定的服务器的完整信息列表
+     */
+    getServersByUid(uid: number): Promise<Server[]>;
+    /**
+     * 根据 channel id 获取服务器列表
+     * @param cid 频道的 channel id
+     * @returns 该频道绑定的服务器的完整信息列表
+     */
+    getServersByCid(cid: string): Promise<Server[]>;
+    /**
+     * 根据 id 获取服务器信息
+     */
+    getServerById(id: number): Promise<Server | null>;
+    /**
+     * 根据名称查找服务器
+     */
+    getServerByName(name: string): Promise<Server | null>;
+    /**
+     * 根据类型筛选服务器
+     */
+    getServersByType(type: TServer): Promise<Server[]>;
+    /**
+     * 创建一个新的服务器记录并关联到用户
+     * @param serverData 要插入的数据 (不含 id)
+     * @param uid 用户的 ID
+     * @returns 插入后的完整数据
+     */
+    createServerForUser(serverData: Omit<Server, 'id'>, uid: number): Promise<Server>;
+    /**
+     * 创建一个新的服务器记录并关联到频道
+     * @param serverData 要插入的数据 (不含 id)
+     * @param cid 频道的 ID
+     * @returns 插入后的完整数据
+     */
+    createServerForChannel(serverData: Omit<Server, 'id'>, cid: string): Promise<Server>;
+    /**
+     * 更新服务器记录
+     * @param id 服务器 id
+     * @param partial 要更新的字段
+     */
+    updateServer(id: number, partial: Partial<Omit<Server, 'id'>>): Promise<void>;
+    /**
+     * 删除服务器记录
+     * @param id 服务器 id
+     */
+    removeServer(id: number): Promise<void>;
+}

package/lib/core/types/index.d.ts

@@ -0,0 +1,16 @@
+import { TServer } from "../../types";
+import { TGame } from "../../types";
+export interface Card {
+    id: number;
+    code: string;
+    name: string;
+    defaultServerId: number;
+}
+export interface Server {
+    id: number;
+    type: TServer;
+    name: string;
+    baseUrl: string;
+    pcbid?: string;
+    supportedGames: TGame[];
+}

package/lib/core/utils/card.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 将 e-Amusement 卡号（16 个十六进制字符，对应 8 字节）转换为 KONAMI ID（16字符，从 ALPHABET 中取值）
+ * @param uid e-Amusement 卡号（十六进制字符串，必须为 16 位，大写或小写皆可）
+ * @returns KONAMI ID 字符串
+ */
+export declare function toKonamiId(uid: string): string;
+/**
+ * 将 KONAMI ID（16字符）转换回 e-Amusement 卡号（16 个十六进制字符）
+ * @param konamiId KONAMI ID 字符串
+ * @returns e-Amusement 卡号（16 位十六进制字符串，大写）
+ */
+export declare function toUid(konamiId: string): string;
+/**
+ * 判断给定的字符串是 UID、KONAMI ID 还是非法字符串。
+ * @param input 待判断的字符串
+ * @returns "uid" 表示 e-Amusement UID, "konamiid" 表示 KONAMI ID, "invalid" 表示非法字符串.
+ */
+export declare function classifyCardId(input: string): "uid" | "konamiid" | "invalid";
+/**
+ * 处理用户输入的卡号。
+ * @param input 用户输入的卡号
+ * @returns 修正后的全大写字符串
+ */
+export declare function processInputCardCode(input: string): string;

package/lib/core/utils/role.d.ts

@@ -0,0 +1,6 @@
+import { Session } from 'koishi';
+import { CoreConfig } from '../../types/config';
+export * from '../config';
+export declare function hasPermission(...perms: boolean[]): boolean;
+export declare function isPluginAdmin(session: Session, config: CoreConfig): boolean;
+export declare function isGuildAdmin(session: Session): boolean;

package/lib/drawer/BaseDrawer.d.ts

@@ -0,0 +1,19 @@
+import { Context } from 'koishi';
+import { IDrawer } from '../types';
+/**
+ * Base drawer class that provides common functionality for all drawers
+ */
+export declare abstract class BaseDrawer implements IDrawer {
+    ctx: Context;
+    constructor(ctx: Context);
+    /**
+     * Compress an image buffer
+     * @param canvas The canvas object to compress
+     * @param compression Compression options
+     * @returns Promise resolving to a compressed buffer
+     */
+    protected compressImage(canvas: any, compression?: {
+        lossless: boolean;
+        quality?: number;
+    }): Promise<Buffer>;
+}

package/lib/drawer/Core/index.d.ts

@@ -0,0 +1,22 @@
+import { Context } from 'koishi';
+import { BaseDrawer } from '../BaseDrawer';
+export declare class CoreDrawer extends BaseDrawer {
+    ctx: Context;
+    constructor(ctx: Context);
+    /**
+     * Generate a generic image for core functionality
+     * @param options Configuration options for image generation
+     * @param compression Compression options
+     * @returns Promise resolving to a Buffer containing the image data
+     */
+    generateImage(options?: {
+        width?: number;
+        height?: number;
+        text?: string;
+        backgroundColor?: string;
+        textColor?: string;
+    }, compression?: {
+        lossless: boolean;
+        quality?: number;
+    }): Promise<Buffer>;
+}

package/lib/drawer/DrawerFactory.d.ts

@@ -0,0 +1,8 @@
+import { Context } from "koishi";
+import { IDrawer, TGame } from '../types';
+export declare class DrawerFactory {
+    private ctx;
+    private drawerInstances;
+    constructor(ctx: Context);
+    getDrawer(drawerType: TGame | 'core'): IDrawer;
+}

package/lib/drawer/IIDX/index.d.ts

@@ -0,0 +1,29 @@
+import { Context } from 'koishi';
+import { BaseDrawer } from '../BaseDrawer';
+export declare class IIDXDrawer extends BaseDrawer {
+    ctx: Context;
+    constructor(ctx: Context);
+    /**
+     * Generate an image for IIDX data
+     * @param options Configuration options for image generation
+     * @param compression Compression options
+     * @returns Promise resolving to a Buffer containing the image data
+     */
+    generateImage(options?: {
+        width?: number;
+        height?: number;
+        playerName?: string;
+        backgroundColor?: string;
+        textColor?: string;
+        dj_level?: string;
+        sp_dan?: string;
+        dp_dan?: string;
+    }, compression?: {
+        lossless: boolean;
+        quality?: number;
+    }): Promise<Buffer>;
+    /**
+     * Draw ranking information
+     */
+    private drawRankingInfo;
+}

package/lib/drawer/SDVX/index.d.ts

@@ -0,0 +1,35 @@
+import { Context } from 'koishi';
+import { BaseDrawer } from '../BaseDrawer';
+import { SDVXScore } from '../../games/sdvx/types';
+import { SDVXConfig } from '../../types/config';
+export declare class SDVXDrawer extends BaseDrawer {
+    ctx: Context;
+    constructor(ctx: Context);
+    /**
+     * Generate a Volforce image for SDVX scores
+     * @param options Configuration options for image generation
+     * @param compression Compression options
+     * @returns Promise resolving to a Buffer containing the image data
+     */
+    generateVFImage(options: {
+        scores: SDVXScore[];
+        playerName: string;
+        config: SDVXConfig;
+    }, compression?: {
+        lossless: boolean;
+    }): Promise<Buffer>;
+    /**
+     * Draw score cards on the canvas
+     */
+    private drawScoreCards;
+    /**
+     * Get abbreviation for a difficulty level
+     */
+    private getDifficultyAbbreviation;
+    /**
+     * Calculate the average volforce from best 50 scores
+     */
+    private calculateAverageVF;
+    private wrapText;
+    private roundRect;
+}

package/lib/drawer/index.d.ts

@@ -0,0 +1,13 @@
+import type { AppConfig } from "../types/config";
+import { Context } from "koishi";
+import { TGame } from '../types';
+export declare const name = "Noah-Drawer";
+export declare class DrawerManager {
+    private static instance;
+    private factory;
+    private logger;
+    private constructor();
+    static getInstance(ctx: Context): DrawerManager;
+    getDrawer(gameType: TGame | 'core'): import("../types").IDrawer;
+}
+export declare function apply(ctx: Context, config: AppConfig): void;

package/lib/games/sdvx/command.d.ts

@@ -0,0 +1,4 @@
+import { Context } from "koishi";
+import { SDVXConfig } from "../../types/config";
+export declare const name = "command";
+export declare function apply(ctx: Context, config: SDVXConfig): void;

package/lib/games/sdvx/commands/vf.d.ts

@@ -0,0 +1,3 @@
+import { Context } from 'koishi';
+import { SDVXConfig } from '../../../types/config';
+export declare function vf(ctx: Context, config: SDVXConfig): void;

package/lib/games/sdvx/config.d.ts

@@ -0,0 +1,2 @@
+import { SDVXConfig } from '../../types/config';
+export declare const sdvxConfig: SDVXConfig;

package/lib/games/sdvx/database.d.ts

@@ -0,0 +1,3 @@
+import { Context } from "koishi";
+export declare const name = "database";
+export declare function apply(ctx: Context): void;

package/lib/games/sdvx/event.d.ts

@@ -0,0 +1,3 @@
+import { Context } from "koishi";
+export declare const name = "event";
+export declare function apply(ctx: Context): void;

package/lib/games/sdvx/index.d.ts

@@ -0,0 +1,6 @@
+import { Context, Logger } from "koishi";
+import type { AppConfig } from "../../types/config";
+export declare const name = "Noah-SDVX";
+export declare const inject: string[];
+export declare const logger: Logger;
+export declare function apply(ctx: Context, config: AppConfig): Promise<void>;

package/lib/games/sdvx/services/music-service.d.ts

@@ -0,0 +1,10 @@
+import { Context } from 'koishi';
+import { SDVXMusic } from '../types';
+import { SDVXConfig } from '../../../types/config';
+export declare class MusicService {
+    private static instance;
+    private sdvx_data_url;
+    private constructor();
+    static getInstance(config: SDVXConfig): MusicService;
+    getMusic(ctx: Context, musicIds: number[]): Promise<SDVXMusic[]>;
+}

package/lib/games/sdvx/services/score-service.d.ts

@@ -0,0 +1,18 @@
+import { SDVXScore } from '../types';
+export declare class ScoreService {
+    private static instance;
+    private constructor();
+    static getInstance(): ScoreService;
+    /**
+     * Sort scores by volforce in descending order
+     * @param scores Array of SDVX scores to sort
+     * @returns New array of scores sorted by volforce (highest to lowest)
+     */
+    sortByVolforce(scores: SDVXScore[]): SDVXScore[];
+    /**
+     * Get the top 50 scores by volforce, including ties
+     * @param scores Array of SDVX scores to process
+     * @returns Array of scores with highest volforce values (may exceed 50 if there are ties)
+     */
+    getBest50(scores: SDVXScore[]): SDVXScore[];
+}

package/lib/games/sdvx/types/index.d.ts

@@ -0,0 +1,82 @@
+export interface SDVXProfile {
+}
+export interface SDVXScore {
+    music: {
+        music_id: number;
+        music_diff: number;
+        music_diff_name: string;
+        music_diff_full_name: string;
+        score: number;
+        exscore: number;
+        clear_type: SDVXClearType;
+        score_grade: SDVXGrade;
+        btn_rate: string;
+        long_rate: string;
+        vol_rate: string;
+    };
+    extra: {
+        volforce: number;
+        play_count: number;
+        update_at: string;
+    };
+    music_data: SDVXMusic;
+    difficulty_data: SDVXMusicDifficulty;
+}
+export type SDVXGrade = 'S' | 'AAA+' | 'AAA' | 'AA+' | 'AA' | 'A+' | 'A' | 'B' | 'C' | 'D';
+export type SDVXClearType = 'S-PUC' | 'PUC' | 'UC' | 'HC' | 'NC' | 'PLAYED' | 'NO PLAY';
+export interface SDVXMusicDifficulty {
+    difstr: string;
+    difnum: number;
+    raw_illustrator: string;
+    illustrator: string;
+    raw_effected_by: string;
+    effected_by: string;
+    price: number;
+    limited: number;
+    jacket_print: number;
+    jacket_mask: number;
+    max_exscore: number;
+    max_chain: number;
+    chip_count: number;
+    hold_count: number;
+    tsumami_count: number;
+    radar: {
+        notes: number;
+        peak: number;
+        tsumami: number;
+        tricky: number;
+        hand_trip: number;
+        one_hand: number;
+    };
+    big_cover_url: string;
+    cover_url: string;
+    chart_url: string;
+    mirror_chart_url: string;
+}
+export interface SDVXMusic {
+    id: number;
+    label: string;
+    raw_title_name: string;
+    title_name: string;
+    main_title_name: string;
+    sub_title_name: string;
+    title_yomigana: string;
+    title_romaji: string;
+    raw_artist_name: string;
+    artist_name: string;
+    artist_yomigana: string;
+    artist_romaji: string;
+    ascii: string;
+    bpm_max: string;
+    bpm_min: string;
+    distribution_date: string;
+    volume: number;
+    bg_no: number;
+    genre: number;
+    genre_name: string;
+    is_fixed: number;
+    version: number;
+    demo_pri: number;
+    inf_ver: number;
+    difficulty: SDVXMusicDifficulty[];
+}

package/lib/games/sdvx/utils/vf.d.ts

@@ -0,0 +1,19 @@
+import { SDVXGrade, SDVXClearType, SDVXScore } from '../types';
+/**
+ * Calculate volforce based on score, level, grade, and clear type
+ * @param raw_score score object from the API
+ * @returns The calculated volforce value
+ */
+export declare function calculateVolforce(raw_score: SDVXScore): number;
+/**
+ * Get grade factor for a given grade
+ * @param grade The grade to get the factor for
+ * @returns The grade factor
+ */
+export declare function getGradeFactor(grade: SDVXGrade): number;
+/**
+ * Get clear factor for a given clear type
+ * @param clearType The clear type to get the factor for
+ * @returns The clear factor
+ */
+export declare function getClearFactor(clearType: SDVXClearType): number;

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+import { Context } from 'koishi';
+import type { AppConfig } from "./types/config";
+export declare const name = "noah";
+export declare const inject: string[];
+export * from './config';
+export declare function apply(ctx: Context, config: AppConfig): void;