cc-discord-framework-plugin 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuya Nakayama
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,2 @@
+# cc-discord-framework-plugin
+

package/dist/SoundCloudPlugin/SoundCloudPlugin.d.ts

@@ -0,0 +1,19 @@
+import { type AudioResource } from "@discordjs/voice";
+import type { QueuePlugin } from "cc-discord-framework/modules";
+import { SoundCloudTrack } from "play-dl";
+interface SearchCallbacks {
+    notFound?: () => void;
+    choice: (results: SoundCloudTrack[]) => Promise<string> | string | null;
+}
+export declare class SoundCloudPlugin implements QueuePlugin {
+    nowTrack: SoundCloudTrack | null;
+    private static isReady;
+    private url;
+    constructor();
+    private setup;
+    search(query: string, options: {
+        limit: number;
+    } | undefined, callbacks: SearchCallbacks): Promise<SoundCloudPlugin | null>;
+    createResource(): Promise<AudioResource>;
+}
+export {};

package/dist/SoundCloudPlugin/SoundCloudPlugin.js

@@ -0,0 +1,55 @@
+import { createAudioResource as CAR } from "@discordjs/voice";
+import { Logger } from "cc-discord-framework";
+import playDl, { SoundCloudTrack } from "play-dl";
+export class SoundCloudPlugin {
+    nowTrack = null;
+    static isReady = false;
+    url = null;
+    constructor() {
+        this.setup();
+    }
+    // 準備
+    async setup() {
+        if (!SoundCloudPlugin.isReady) {
+            const client_id = await playDl.getFreeClientID();
+            await playDl.setToken({
+                soundcloud: { client_id }
+            });
+            SoundCloudPlugin.isReady = true;
+        }
+    }
+    // 検索
+    async search(query, options = { limit: 5 }, callbacks) {
+        await this.setup();
+        const results = await playDl.search(query, {
+            source: { soundcloud: "tracks" },
+            limit: options.limit
+        });
+        // 検索ヒットなし
+        if (!results || results.length === 0) {
+            callbacks.notFound?.();
+            return null;
+        }
+        // urlを選択させる
+        this.url = await callbacks.choice(results);
+        if (!this.url)
+            return null;
+        this.nowTrack = results.find(t => t.url === this.url) || null;
+        return this;
+    }
+    // 音源データ作成
+    async createResource() {
+        if (!this.url) {
+            Logger.error("[SoundCloudPlugin] URLが設定されていません");
+            throw new Error("URL_NOT_SET");
+        }
+        try {
+            const streamData = await playDl.stream(this.url);
+            return CAR(streamData.stream, { inputType: streamData.type });
+        }
+        catch (error) {
+            Logger.error(error);
+            throw error;
+        }
+    }
+}

package/dist/SoundCloudPlugin/index.d.ts

@@ -0,0 +1 @@
+export * from "./SoundCloudPlugin.js";

package/dist/SoundCloudPlugin/index.js

@@ -0,0 +1 @@
+export * from "./SoundCloudPlugin.js";

package/dist/VoiceVoxPlugin/VoiceVoxPlugin.d.ts

@@ -0,0 +1,23 @@
+import type { QueuePlugin } from "cc-discord-framework/modules";
+import { type AudioResource } from "@discordjs/voice";
+export interface GenerateOptions {
+    text: string;
+    speakerId: number;
+    speed?: number;
+    pitch?: number;
+    intonation?: number;
+}
+export declare class VoiceVoxPlugin implements QueuePlugin {
+    private readonly baseUrl;
+    private readonly cacheKey;
+    private guildId;
+    private audioBuffer;
+    constructor(options?: {
+        baseUrl?: string;
+    });
+    registerReadPlace(guildId: string, channelId: string): void;
+    getReadPlace(guildId: string): string | undefined;
+    generate(options: GenerateOptions): Promise<this>;
+    createResource(): Promise<AudioResource>;
+    destroy(): Promise<void>;
+}

package/dist/VoiceVoxPlugin/VoiceVoxPlugin.js

@@ -0,0 +1,68 @@
+import { Logger, Cache } from "cc-discord-framework";
+import { createAudioResource as CAR, StreamType } from "@discordjs/voice";
+import { Readable } from "stream";
+import axios from "axios";
+export class VoiceVoxPlugin {
+    baseUrl;
+    cacheKey = "VoiceVoxCache";
+    guildId = null;
+    audioBuffer = null;
+    constructor(options) {
+        this.baseUrl = options?.baseUrl ?? "http://voicevox:50021";
+    }
+    // 読み上げ場所登録
+    registerReadPlace(guildId, channelId) {
+        this.guildId = guildId;
+        Cache.set(Cache.key(this.cacheKey, guildId), channelId);
+    }
+    // 読み上げ場所取得
+    getReadPlace(guildId) {
+        return Cache.get(Cache.key(this.cacheKey, guildId));
+    }
+    // 読み上げ素材を生成
+    async generate(options) {
+        try {
+            const queryRes = await axios.post(`${this.baseUrl}/audio_query`, null, {
+                params: { text: options.text, speaker: options.speakerId }
+            });
+            const queryData = queryRes.data;
+            if (options.speed)
+                queryData.speedScale = options.speed;
+            if (options.pitch)
+                queryData.pitchScale = options.pitch;
+            if (options.intonation)
+                queryData.intonationScale = options.intonation;
+            const synthRes = await axios.post(`${this.baseUrl}/synthesis`, queryData, {
+                params: { speaker: options.speakerId },
+                responseType: "arraybuffer"
+            });
+            this.audioBuffer = Buffer.from(synthRes.data);
+            return this;
+        }
+        catch (error) {
+            Logger.error(error);
+            throw error;
+        }
+    }
+    // 音源データ作成
+    async createResource() {
+        if (!this.audioBuffer) {
+            Logger.error("[VoiceVoxPlugin] 音声データが生成されていません");
+            throw new Error("BUFFER_NOT_SET");
+        }
+        try {
+            const stream = Readable.from(this.audioBuffer);
+            return CAR(stream, { inputType: StreamType.Arbitrary });
+        }
+        catch (error) {
+            Logger.error(error);
+            throw error;
+        }
+    }
+    // 解放時
+    async destroy() {
+        if (this.guildId) {
+            Cache.delete(Cache.key(this.cacheKey, this.guildId));
+        }
+    }
+}

package/dist/VoiceVoxPlugin/index.d.ts

@@ -0,0 +1 @@
+export * from "./VoiceVoxPlugin.js";

package/dist/VoiceVoxPlugin/index.js

@@ -0,0 +1 @@
+export * from "./VoiceVoxPlugin.js";

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./SoundCloudPlugin/index.js";
+export * from "./VoiceVoxPlugin/index.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./SoundCloudPlugin/index.js";
+export * from "./VoiceVoxPlugin/index.js";

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "cc-discord-framework-plugin",
+  "version": "1.0.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CHACCHAN/cc-discord-framework-plugin.git"
+  },
+  "description": "cc-discord-framework official plugins",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "private": false,
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "module": "src/index.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run clean && bun run build"
+  },
+  "dependencies": {
+    "cc-discord-framework": "latest",
+    "@discordjs/voice": "^0.19.2",
+    "play-dl": "^1.9.7",
+    "axios": "^1.16.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^6.0.3"
+  }
+}