@serverkgg/bridge 0.1.4 → 0.1.5

package/src/bot/botDeploy.ts

@@ -1,13 +1,15 @@
 import type { BridgeContext } from "../context";
 import type { BridgeValues } from "../core";
 import type { BridgeEventPattern } from "../modules";
-import { BridgeEventName } from "../protocol";
+import { BridgeCrashPhase, type BridgeCrashReport, BridgeEventName } from "../protocol";
 import {
 	BOT_STATE_DIR,
 	BotDeploymentOutcome,
 	BotDeploymentSource,
-	type BotDeploymentStage,
+	BotDeploymentStage,
+	type BotDeploymentState,
 	readDeploymentState,
+	writeDeploymentState,
 } from "./botState";
 
 export const DEPLOY_MARKER = `${BOT_STATE_DIR}/deploy-requested`;
@@ -23,6 +25,8 @@ export const DEPLOYMENT_DETAIL_LIMIT = 200;
 
 export const DEPLOYMENT_COMMIT_LENGTH = 12;
 
+export const BOT_READY_GRACE_SECONDS = 20;
+
 export interface DeployRequest {
 	deployment: string | null;
 	ref: string | null;
@@ -77,6 +81,116 @@ export const deploymentEvent = (deployment: string, commit: string | null): Brid
 	};
 };
 
+export const deploymentFailedEvent = (deployment: string, stage: BotDeploymentStage, detail: string): BridgeValues => {
+	return {
+		kind: DEPLOYMENT_EVENT_KIND,
+		deployment,
+		outcome: BotDeploymentOutcome.Failed,
+		stage,
+		detail,
+	};
+};
+
+type ReadinessContext = Pick<BridgeContext, "files" | "log" | "emit">;
+
+const commitOf = (state: BotDeploymentState) => {
+	return state.source === BotDeploymentSource.Git ? state.commit : null;
+};
+
+export const pendingDeploymentOf = (
+	state: BotDeploymentState | null,
+	launchedAt: number,
+): BotDeploymentState | null => {
+	if (
+		state === null
+		|| state.deployment === null
+		|| state.outcome !== BotDeploymentOutcome.Ready
+		|| state.settled === true
+	) {
+		return null;
+	}
+
+	if (state.settled === false) {
+		return state;
+	}
+
+	const finishedAt = Date.parse(state.finishedAt);
+
+	return Number.isFinite(finishedAt) && finishedAt >= launchedAt ? state : null;
+};
+
+export const createBotReadiness = () => {
+	let launchedAt = Number.POSITIVE_INFINITY;
+	let pending: Promise<BotDeploymentState | null> = Promise.resolve(null);
+
+	const take = async () => {
+		const state = await pending;
+
+		pending = Promise.resolve(null);
+
+		return state;
+	};
+
+	return {
+		launching(at: number = Date.now()) {
+			launchedAt = at;
+			pending = Promise.resolve(null);
+		},
+
+		async ready(context: ReadinessContext) {
+			const read = async () => {
+				return pendingDeploymentOf(await readDeploymentState(context.files), launchedAt);
+			};
+
+			pending = read();
+
+			await pending;
+		},
+
+		async stable(context: ReadinessContext) {
+			const state = await take();
+
+			if (state === null || state.deployment === null) {
+				return;
+			}
+
+			context.emit(BridgeEventName.ServerUpdated, deploymentEvent(state.deployment, commitOf(state)));
+
+			await writeDeploymentState(context.files, {
+				...state,
+				settled: true,
+			});
+		},
+
+		async exit(context: ReadinessContext, report: BridgeCrashReport) {
+			const state = await take();
+
+			if (state === null || state.deployment === null || report.phase !== BridgeCrashPhase.Booting) {
+				return;
+			}
+
+			context.log.warn("the bot exited before it was ready, the deployment failed", {
+				deployment: state.deployment,
+				cause: report.cause,
+			});
+
+			context.emit(
+				BridgeEventName.ServerUpdated,
+				deploymentFailedEvent(state.deployment, BotDeploymentStage.Start, report.cause),
+			);
+
+			await writeDeploymentState(context.files, {
+				...state,
+				outcome: BotDeploymentOutcome.Failed,
+				stage: BotDeploymentStage.Start,
+				detail: report.cause,
+				finishedAt: new Date().toISOString(),
+				settled: true,
+			});
+		},
+	};
+};
+
 export const deployPending = async (context: Pick<BridgeContext, "files" | "server">) => {
 	return context.server.running && (await context.files.exists(DEPLOY_MARKER));
 };
@@ -94,14 +208,19 @@ const alreadyLive = async (context: DeployContext, request: DeployRequest) => {
 		return false;
 	}
 
+	if (state.settled === false) {
+		context.log("the deployment is running but has not proven itself yet, its outcome follows", {
+			deployment: request.deployment,
+		});
+
+		return true;
+	}
+
 	context.log("the deployment is already live, nothing to do", {
 		deployment: request.deployment,
 	});
 
-	context.emit(
-		BridgeEventName.ServerUpdated,
-		deploymentEvent(request.deployment, state.source === BotDeploymentSource.Git ? state.commit : null),
-	);
+	context.emit(BridgeEventName.ServerUpdated, deploymentEvent(request.deployment, commitOf(state)));
 
 	return true;
 };

package/src/bot/botState.ts

@@ -20,6 +20,7 @@ export enum BotDeploymentStage {
 	Sync = "sync",
 	Snapshot = "snapshot",
 	Install = "install",
+	Build = "build",
 	Start = "start",
 }
 
@@ -33,6 +34,7 @@ export const botDeploymentStateSchema = z.object({
 	stage: z.enum(BotDeploymentStage).nullable(),
 	detail: z.string().nullable(),
 	finishedAt: z.string(),
+	settled: z.boolean().optional(),
 });
 
 export type BotDeploymentState = z.infer<typeof botDeploymentStateSchema>;
@@ -52,3 +54,7 @@ export const readDeploymentState = async (
 		return null;
 	}
 };
+
+export const writeDeploymentState = async (files: Pick<BridgeFiles, "write">, state: BotDeploymentState) => {
+	await files.write(DEPLOYMENT_STATE_FILE, `${JSON.stringify(state, null, "\t")}\n`);
+};

package/src/bot/detect/botInspectWarning.ts

@@ -1,11 +1,13 @@
 export enum BotInspectWarning {
 	NoLockfile = "no-lockfile",
+	NodeVersionUnmet = "node-version-unmet",
+	LockfileNotHonoured = "lockfile-not-honoured",
 	NoStart = "no-start",
 	NoManifest = "no-manifest",
-	TypescriptEntry = "typescript-entry",
 	EnvCommitted = "env-committed",
 	NodeModulesCommitted = "node-modules-committed",
 	VenvCommitted = "venv-committed",
+	DatabaseCommitted = "database-committed",
 	UnpinnedRequirements = "unpinned-requirements",
 	TwoRuntimes = "two-runtimes",
 	TwoPlatforms = "two-platforms",

package/src/bot/detect/botPackageManager.ts

@@ -2,5 +2,8 @@ export enum BotPackageManager {
 	Npm = "npm",
 	Pnpm = "pnpm",
 	Yarn = "yarn",
+	Bun = "bun",
 	Pip = "pip",
+	Uv = "uv",
+	Pipenv = "pipenv",
 }

package/src/bot/detect/corpus/alexmubarakshin-ts-telegraf-boilerplate.json

@@ -0,0 +1,37 @@
+{
+	"source": {
+		"url": "https://github.com/AlexMubarakshin/ts-telegraf-boilerplate",
+		"branch": "main",
+		"commit": "97cb2ceebb3c3c87c779801b67ae731ed5ea958d",
+		"stars": 14
+	},
+	"files": [
+		".env.example",
+		".eslintrc.js",
+		".gitignore",
+		".prettierrc",
+		"Readme.md",
+		"babel.config.js",
+		"package.json",
+		"src/index.ts",
+		"tsconfig.json",
+		"yarn.lock"
+	],
+	"contents": {
+		".env.example": "BOT_TOKEN=\n\nSERVER_PORT=3000\n\nLOGS_OUTPUT=logs.log",
+		"package.json": "{\n  \"name\": \"ts-telegraf-boilerplate\",\n  \"version\": \"1.0.0\",\n  \"description\": \"A personal TypeScript-based boilerplate for Telegram bot development using Telegraf\",\n  \"main\": \"index.js\",\n  \"repository\": \"https://github.com/AlexMubarakshin/ts-telegraf-boilerplate\",\n  \"author\": \"Alex Mubarakshin\",\n  \"license\": \"MIT\",\n  \"scripts\": {\n    \"build\": \"tsc\",\n    \"eslint:lint\": \"eslint . --ext .ts\",\n    \"eslint:fix\": \"eslint . --ext .ts --fix\",\n    \"lint\": \"yarn prettier:check && yarn eslint:lint && yarn type-check\",\n    \"prettier:check\": \"npm exec prettier -- --check './src/**/*.{js,jsx,ts,tsx,scss,css}'\",\n    \"prettier:fix\": \"npm exec prettier -- --write './src/**/*.{js,jsx,ts,tsx}'\",\n    \"start\": \"node dist/index.js\",\n    \"start:inspect\": \"node --inspect dist/index.js\",\n    \"type-check\": \"tsc --noEmit --skipLibCheck\",\n    \"test\": \"jest\"\n  },\n  \"dependencies\": {\n    \"dotenv\": \"16.3.1\",\n    \"eslint-plugin-prettier\": \"5.0.0\",\n    \"telegraf\": \"4.14.0\",\n    \"winston\": \"3.10.0\"\n  },\n  \"devDependencies\": {\n    \"@babel/core\": \"7.23.0\",\n    \"@babel/preset-env\": \"7.22.20\",\n    \"@babel/preset-typescript\": \"7.23.0\",\n    \"@types/jest\": \"29.5.5\",\n    \"@typescript-eslint/eslint-plugin\": \"6.7.3\",\n    \"@typescript-eslint/parser\": \"6.7.3\",\n    \"babel-jest\": \"29.7.0\",\n    \"eslint\": \"8.50.0\",\n    \"eslint-plugin-import-helpers\": \"1.3.1\",\n    \"jest\": \"29.7.0\",\n    \"prettier\": \"3.0.3\",\n    \"typescript\": \"5.2.2\"\n  }\n}\n"
+	},
+	"expected": {
+		"runtime": "node",
+		"packageManager": "yarn",
+		"framework": "telegraf",
+		"platform": "telegram",
+		"install": "corepack yarn install --frozen-lockfile",
+		"build": "corepack yarn run build",
+		"start": "node dist/index.js",
+		"nodeVersion": null,
+		"pythonVersion": null,
+		"tokenKey": "BOT_TOKEN",
+		"warnings": []
+	}
+}

package/src/bot/detect/corpus/alsarmad-discord-quran-bot.json

@@ -0,0 +1,40 @@
+{
+	"source": {
+		"url": "https://github.com/Alsarmad/discord-quran-bot",
+		"branch": "master",
+		"commit": "ce4706ed9a8805552eacb2d673de636aeef22e9b",
+		"stars": 7
+	},
+	"files": [
+		".env.example",
+		".gitignore",
+		"LICENSE",
+		"Procfile",
+		"README.md",
+		"app.json",
+		"package.json",
+		"src/index.ts",
+		"tsconfig.json"
+	],
+	"contents": {
+		".env.example": "DISCORD_TOKEN=your-discord-token-here\nSTATUS=",
+		"Procfile": "worker: node dist/index",
+		"package.json": "{\n   \"name\": \"quran-bot\",\n   \"version\": \"1.0.0\",\n   \"description\": \"A Discord bot that can play Qur'an recitations in voice/stage channel.\",\n   \"main\": \"dist/index.js\",\n   \"scripts\": {\n      \"build\": \"tsc\",\n      \"start\": \"npm run build && node dist/index\"\n   },\n   \"author\": \"TheMaestroo\",\n   \"dependencies\": {\n      \"@discordjs/voice\": \"^0.14.0\",\n      \"arabic2franko\": \"^1.0.3\",\n      \"discord.js\": \"^13.1.0\",\n      \"dotenv\": \"^16.0.3\",\n      \"ffmpeg-static\": \"^5.1.0\",\n      \"fuse.js\": \"^6.4.6\",\n      \"libsodium-wrappers\": \"^0.7.9\",\n      \"ms\": \"^3.0.0-canary.1\",\n      \"node-fetch\": \"^3.3.0\"\n   },\n   \"devDependencies\": {\n      \"@types/node-fetch\": \"^2.5.10\",\n      \"typescript\": \"^4.4.3\"\n   },\n   \"engines\": {\n      \"node\": \"16.x\"\n   }\n}\n"
+	},
+	"expected": {
+		"runtime": "node",
+		"packageManager": "npm",
+		"framework": "discord-js",
+		"platform": "discord",
+		"install": "npm install",
+		"build": "npm run build",
+		"start": "node dist/index",
+		"nodeVersion": "16",
+		"pythonVersion": null,
+		"tokenKey": "DISCORD_TOKEN",
+		"warnings": [
+			"no-lockfile",
+			"node-version-unmet"
+		]
+	}
+}

package/src/bot/detect/corpus/anasty17-mirror-leech-telegram-bot.json

@@ -0,0 +1,50 @@
+{
+	"source": {
+		"url": "https://github.com/anasty17/mirror-leech-telegram-bot",
+		"branch": "master",
+		"commit": "795effa69fe6b89af4183bc518195b7a2fffdf54",
+		"stars": 4320
+	},
+	"files": [
+		".dockerignore",
+		".gitignore",
+		"Dockerfile",
+		"LICENSE",
+		"README.md",
+		"_config.yml",
+		"add_to_team_drive.py",
+		"aria-nox-nzb.sh",
+		"bot/__main__.py",
+		"captain-definition",
+		"config_sample.py",
+		"docker-compose.yml",
+		"driveid.py",
+		"gen_sa_accounts.py",
+		"generate_drive_token.py",
+		"generate_string_session.py",
+		"pytest.ini",
+		"requirements-cli.txt",
+		"requirements-dev.txt",
+		"requirements.txt",
+		"start.sh",
+		"update.py"
+	],
+	"contents": {
+		"requirements.txt": "asyncio\naiofiles\naioshutil\nanytree\napscheduler\naioaria2\naioqbt\ncloudscraper\ndnspython\nfastapi\nfeedparser\ngoogle-api-python-client\ngoogle-auth-httplib2\ngoogle-auth-oauthlib\ngunicorn\nhttpx\njinja2\nlxml\nnatsort\npar2cmdline-turbo\npillow\npsutil\npymongo\nkurigram\npython-magic\nrequests\ntelegraph\ntenacity\ntgcrypto\nurllib3\nuvicorn\nuvloop\nxattr\ngallery-dl\nyt-dlp[default,curl-cffi]\n"
+	},
+	"expected": {
+		"runtime": "python",
+		"packageManager": "pip",
+		"framework": null,
+		"platform": null,
+		"install": "uv pip install -r requirements.txt",
+		"build": null,
+		"start": "python -m bot",
+		"nodeVersion": null,
+		"pythonVersion": null,
+		"tokenKey": null,
+		"warnings": [
+			"unpinned-requirements"
+		]
+	}
+}

package/src/bot/detect/corpus/anidiotsguide-guidebot.json

@@ -0,0 +1,36 @@
+{
+	"source": {
+		"url": "https://github.com/AnIdiotsGuide/guidebot",
+		"branch": "master",
+		"commit": "725fc1460ca276282c27a775b5f9915154983ecc",
+		"stars": 471
+	},
+	"files": [
+		".env-example",
+		".eslintrc.json",
+		".gitignore",
+		"LICENSE",
+		"README.md",
+		"config.js.example",
+		"index.js",
+		"package-lock.json",
+		"package.json",
+		"yarn.lock"
+	],
+	"contents": {
+		"package.json": "{\n  \"name\": \"guidebot\",\n  \"version\": \"2.1.0\",\n  \"description\": \"A boilerplate example bot with command handler and reloadable commands. Updated and Maintained by the Idiot's Guide Community\",\n  \"main\": \"index.js\",\n  \"scripts\": {\n    \"start\": \"node index.js\"\n  },\n  \"engines\": {\n    \"node\": \">=16\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/AnIdiotsGuide/guidebot.git\"\n  },\n  \"author\": \"Evelyne Lachance <eslachance@gmail.com> (http://evie.codes)\",\n  \"contributors\": [\n    \"York (http://anidiots.guide)\"\n  ],\n  \"license\": \"MIT\",\n  \"bugs\": {\n    \"url\": \"https://github.com/AnIdiotsGuide/guidebot/issues\"\n  },\n  \"homepage\": \"https://github.com/AnIdiotsGuide/guidebot#readme\",\n  \"dependencies\": {\n    \"@discordjs/builders\": \"^0.2.0\",\n    \"@sapphire/time-utilities\": \"^1.3.8\",\n    \"colorette\": \"^1.3.0\",\n    \"discord.js\": \"^13.0.1\",\n    \"dotenv\": \"^10.0.0\",\n    \"enmap\": \"^5.8.5\"\n  },\n  \"devDependencies\": {\n    \"eslint\": \"^7.30.0\",\n    \"eslint-config-airbnb-base\": \"^14.2.1\",\n    \"eslint-config-standard\": \"^16.0.3\",\n    \"eslint-plugin-import\": \"^2.23.4\",\n    \"eslint-plugin-node\": \"^11.1.0\",\n    \"eslint-plugin-promise\": \"^5.1.0\"\n  }\n}\n"
+	},
+	"expected": {
+		"runtime": "node",
+		"packageManager": "yarn",
+		"framework": "discord-js",
+		"platform": "discord",
+		"install": "corepack yarn install --frozen-lockfile",
+		"build": null,
+		"start": "node index.js",
+		"nodeVersion": "16",
+		"pythonVersion": null,
+		"tokenKey": null,
+		"warnings": []
+	}
+}

package/src/bot/detect/corpus/anonymousx1025-anonxmusic.json

@@ -0,0 +1,45 @@
+{
+	"source": {
+		"url": "https://github.com/AnonymousX1025/AnonXMusic",
+		"branch": "master",
+		"commit": "16e898dcdb271523464315ac1a33ede65adbaf86",
+		"stars": 301
+	},
+	"files": [
+		".dockerignore",
+		".gitignore",
+		".python-version",
+		"Dockerfile",
+		"LICENSE",
+		"Procfile",
+		"anony/__main__.py",
+		"app.json",
+		"config.py",
+		"heroku.yml",
+		"pyproject.toml",
+		"requirements.txt",
+		"sample.env",
+		"setup",
+		"start",
+		"uv.lock"
+	],
+	"contents": {
+		".python-version": "3.13\n",
+		"Procfile": "worker: bash start\n",
+		"pyproject.toml": "[project]\nname = \"anonxmusic\"\nversion = \"3.0.3\"\ndescription = \"Telegram Group Calls Streaming bot with some useful features.\"\nreadme = \".github/README.md\"\nrequires-python = \">=3.10\"\n\ndependencies = [\n    \"aiohttp~=3.14.3\",\n    \"kurigram>=2.2.25\",\n    \"ntgcalls==3.0.0rc1\",\n    \"pillow~=12.3.0\",\n    \"psutil~=7.2.2\",\n    \"py-tgcalls==3.0.0rc1\",\n    \"py-yt-search~=0.8.0\",\n    \"pymongo>=4.17.0\",\n    \"pytgcrypto>=1.2.12\",\n    \"python-dotenv~=1.2.3\",\n    \"yt-dlp[default]>=2026.8.19\",\n]\n",
+		"requirements.txt": "aiohttp~=3.14.3\nkurigram>=2.2.25\nntgcalls==3.0.0rc1\npillow~=12.3.0\npsutil~=7.2.2\npy-tgcalls==3.0.0rc1\npy-yt-search~=0.8.0\npymongo>=4.17.0\npytgcrypto>=1.2.12\npython-dotenv~=1.2.3\nyt-dlp[default]>=2026.8.19\n"
+	},
+	"expected": {
+		"runtime": "python",
+		"packageManager": "pip",
+		"framework": null,
+		"platform": null,
+		"install": "uv pip install -r requirements.txt",
+		"build": null,
+		"start": "bash start",
+		"nodeVersion": null,
+		"pythonVersion": "3.13",
+		"tokenKey": null,
+		"warnings": []
+	}
+}

package/src/bot/detect/corpus/bot-base-telegram-bot-template.json

@@ -0,0 +1,35 @@
+{
+	"source": {
+		"url": "https://github.com/bot-base/telegram-bot-template",
+		"branch": "main",
+		"commit": "0de2bcd599d1986861ee41342cf754c850cb1425",
+		"stars": 445
+	},
+	"files": [
+		".env.example",
+		".gitignore",
+		"README.md",
+		"eslint.config.js",
+		"package-lock.json",
+		"package.json",
+		"src/main.ts",
+		"tsconfig.json"
+	],
+	"contents": {
+		".env.example": "BOT_TOKEN=\nBOT_MODE=polling\nLOG_LEVEL=debug\nDEBUG=true\nBOT_WEBHOOK=https://www.example.com/webhook\nBOT_WEBHOOK_SECRET=RANDOM_SECRET_VALUE\nSERVER_HOST=localhost\nSERVER_PORT=3000\nBOT_ADMINS=[1]",
+		"package.json": "{\n  \"name\": \"telegram-bot-template\",\n  \"type\": \"module\",\n  \"version\": \"0.1.0\",\n  \"private\": true,\n  \"description\": \"Telegram bot starter template\",\n  \"imports\": {\n    \"#root/*\": \"./build/src/*\"\n  },\n  \"author\": \"deptyped <deptyped@gmail.com>\",\n  \"license\": \"MIT\",\n  \"engines\": {\n    \"node\": \">=20.0.0\",\n    \"npm\": \">=8.0.0\"\n  },\n  \"scripts\": {\n    \"lint\": \"eslint .\",\n    \"format\": \"eslint . --fix\",\n    \"typecheck\": \"tsc\",\n    \"build\": \"tsc --noEmit false\",\n    \"dev\": \"tsc-watch --onSuccess \\\"tsx ./src/main.ts\\\"\",\n    \"start\": \"tsc && tsx ./src/main.ts\",\n    \"start:force\": \"tsx ./src/main.ts\",\n    \"prepare\": \"husky || true\"\n  },\n  \"dependencies\": {\n    \"@grammyjs/auto-chat-action\": \"0.1.1\",\n    \"@grammyjs/commands\": \"1.0.8\",\n    \"@grammyjs/hydrate\": \"1.4.1\",\n    \"@grammyjs/i18n\": \"1.1.2\",\n    \"@grammyjs/parse-mode\": \"1.11.1\",\n    \"@grammyjs/runner\": \"2.0.3\",\n    \"@grammyjs/types\": \"3.20.0\",\n    \"@hono/node-server\": \"1.14.2\",\n    \"callback-data\": \"1.1.1\",\n    \"grammy\": \"1.36.1\",\n    \"hono\": \"4.10.3\",\n    \"iso-639-1\": \"3.1.5\",\n    \"pino\": \"9.9.0\",\n    \"pino-pretty\": \"13.0.0\",\n    \"tsx\": \"4.20.4\",\n    \"valibot\": \"0.42.1\"\n  },\n  \"devDependencies\": {\n    \"@antfu/eslint-config\": \"4.12.0\",\n    \"@types/node\": \"^22.15.21\",\n    \"eslint\": \"^9.27.0\",\n    \"husky\": \"^9.1.7\",\n    \"lint-staged\": \"^15.5.1\",\n    \"tsc-watch\": \"^6.3.1\",\n    \"typescript\": \"^5.9.2\"\n  },\n  \"lint-staged\": {\n    \"*.ts\": \"eslint\"\n  }\n}\n"
+	},
+	"expected": {
+		"runtime": "node",
+		"packageManager": "npm",
+		"framework": "grammy",
+		"platform": "telegram",
+		"install": "npm ci",
+		"build": "npm run build",
+		"start": "tsc && tsx ./src/main.ts",
+		"nodeVersion": "20",
+		"pythonVersion": null,
+		"tokenKey": "BOT_TOKEN",
+		"warnings": []
+	}
+}

package/src/bot/detect/corpus/bracketed-templates-discordjs.json

@@ -0,0 +1,40 @@
+{
+	"source": {
+		"url": "https://github.com/Bracketed/templates-discordjs",
+		"branch": "master",
+		"commit": "691dd94ed81e79268f15694ce249774e189a8827",
+		"stars": 1
+	},
+	"files": [
+		".env",
+		".gitignore",
+		".gitmodules",
+		".yarnrc.yml",
+		"README.md",
+		"biome.json",
+		"entrypoint.sh",
+		"package.json",
+		"renovate.json",
+		"tsconfig.json",
+		"tsup.config.ts",
+		"yarn.lock"
+	],
+	"contents": {
+		"package.json": "{\n\t\"name\": \"@ninjaninja140/discord-ts-template\",\n\t\"packageManager\": \"yarn@4.12.0\",\n\t\"private\": true,\n\t\"main\": \"dist/Entrypoint.mjs\",\n\t\"type\": \"module\",\n\t\"author\": {\n\t\t\"name\": \"ninjaninja140\",\n\t\t\"url\": \"https://github.com/ninjaninja140\"\n\t},\n\t\"homepage\": \"https://bracketed.co.uk\",\n\t\"repository\": {\n\t\t\"url\": \"https://github.com/ninjaninja140/templates-discordjs-typescript\"\n\t},\n\t\"dependencies\": {\n\t\t\"@sapphire/framework\": \"^5.5.0\",\n\t\t\"@sapphire/plugin-logger\": \"^4.1.0\",\n\t\t\"@sapphire/plugin-utilities-store\": \"^2.0.3\",\n\t\t\"discord.js\": \"14.25.1\",\n\t\t\"dotenv\": \"^17.2.3\"\n\t},\n\t\"devDependencies\": {\n\t\t\"@biomejs/biome\": \"^2.3.11\",\n\t\t\"@bracketed/tsup-configuration\": \"^1.0.5\",\n\t\t\"@bracketed/typescript-config\": \"^4.7.1\",\n\t\t\"@sapphire/cli\": \"^1.9.3\",\n\t\t\"@swc/core\": \"^1.15.8\",\n\t\t\"@types/node\": \"^25.0.3\",\n\t\t\"esbuild\": \"^0.27.2\",\n\t\t\"esbuild-fix-imports-plugin\": \"^1.0.23\",\n\t\t\"esbuild-plugin-copy\": \"^2.1.1\",\n\t\t\"esbuild-plugin-file-path-extensions\": \"^2.1.4\",\n\t\t\"esbuild-plugin-version-injector\": \"^1.2.1\",\n\t\t\"tsc-alias\": \"^1.8.16\",\n\t\t\"tsconfig-paths\": \"^4.2.0\",\n\t\t\"tsup\": \"^8.5.1\",\n\t\t\"typescript\": \"^5.9.3\"\n\t},\n\t\"scripts\": {\n\t\t\"start\": \"node dist/Entrypoint.mjs\",\n\t\t\"build\": \"tsup\",\n\t\t\"update\": \"yarn upgrade-interactive\"\n\t}\n}\n"
+	},
+	"expected": {
+		"runtime": "node",
+		"packageManager": "yarn",
+		"framework": "discord-js",
+		"platform": "discord",
+		"install": "corepack yarn install --immutable",
+		"build": "corepack yarn run build",
+		"start": "node dist/Entrypoint.mjs",
+		"nodeVersion": null,
+		"pythonVersion": null,
+		"tokenKey": null,
+		"warnings": [
+			"env-committed"
+		]
+	}
+}

package/src/bot/detect/corpus/cog-creators-red-discordbot.json

@@ -0,0 +1,49 @@
+{
+	"source": {
+		"url": "https://github.com/Cog-Creators/Red-DiscordBot",
+		"branch": "V3/develop",
+		"commit": "111a8b885238898bd41ac2e1b93ef91b654d9cf0",
+		"stars": 5727
+	},
+	"files": [
+		".bandit.yml",
+		".cherry_picker.toml",
+		".codeclimate.yml",
+		".git-blame-ignore-revs",
+		".git_archive_info.txt",
+		".gitattributes",
+		".gitignore",
+		".pylintrc",
+		".readthedocs.yml",
+		"CHANGES.rst",
+		"CONTRIBUTING.md",
+		"LICENSE",
+		"MANIFEST.in",
+		"Makefile",
+		"README.md",
+		"SECURITY.md",
+		"crowdin.yml",
+		"make.bat",
+		"make.ps1",
+		"pyproject.toml",
+		"redbot/__main__.py",
+		"setup.py",
+		"tox.ini"
+	],
+	"contents": {
+		"pyproject.toml": "[build-system]\nrequires = [\"setuptools>=64\", \"wheel\"]\nbuild-backend = \"setuptools.build_meta\"\n\n[project]\nname = \"Red-DiscordBot\"\ndescription = \"A highly customisable Discord bot\"\nreadme = \"README.md\"\nauthors = [{ name = \"Cog Creators\" }]\nclassifiers = [\n    \"Development Status :: 5 - Production/Stable\",\n    \"Framework :: AsyncIO\",\n    \"Intended Audience :: Developers\",\n    \"Intended Audience :: End Users/Desktop\",\n    \"License :: OSI Approved :: GNU General Public License v3 (GPLv3)\",\n    \"Natural Language :: English\",\n    \"Operating System :: MacOS :: MacOS X\",\n    \"Operating System :: Microsoft :: Windows\",\n    \"Operating System :: POSIX :: Linux\",\n    \"Programming Language :: Python :: 3 :: Only\",\n    \"Programming Language :: Python :: 3.8\",\n    \"Programming Language :: Python :: 3.9\",\n    \"Programming Language :: Python :: 3.10\",\n    \"Programming Language :: Python :: 3.11\",\n    \"Topic :: Communications :: Chat\",\n]\ndynamic = [\"version\", \"requires-python\", \"dependencies\", \"optional-dependencies\"]\n\n[project.urls]\n\"Homepage\" = \"https://github.com/Cog-Creators/Red-DiscordBot\"\n\"Discord Server\" = \"https://discord.gg/red\"\n\"Documentation\" = \"https://docs.discord.red\"\n\"Donate on Patreon\" = \"https://www.patreon.com/Red_Devs\"\n\"Issue Tracker\" = \"https://github.com/Cog-Creators/Red-DiscordBot/issues\"\n\"Source Code\" = \"https://github.com/Cog-Creators/Red-DiscordBot\"\n\"Changelog\" = \"https://docs.discord.red/en/stable/changelog.html\"\n\n[project.scripts]\nredbot = \"redbot.__main__:main\"\nredbot-setup = \"redbot.setup:run_cli\"\n\n[project.entry-points.pytest11]\nred-discordbot = \"redbot.pytest\"\n\n[tool.black]\nline-length = 99\nrequired-version = '23'\ntarget-version = ['py38']\ninclude = '\\.py$'\nforce-exclude = '''\n/(\n    redbot\\/vendored\n)/\n'''\n\n[tool.pytest.ini_options]\nasyncio_mode = 'auto'\n"
+	},
+	"expected": {
+		"runtime": "python",
+		"packageManager": "pip",
+		"framework": null,
+		"platform": null,
+		"install": "uv pip install .",
+		"build": null,
+		"start": "python -m redbot",
+		"nodeVersion": null,
+		"pythonVersion": null,
+		"tokenKey": null,
+		"warnings": []
+	}
+}

package/src/bot/detect/corpus/cranberriez-discord.ts-bot-template.json

@@ -0,0 +1,35 @@
+{
+	"source": {
+		"url": "https://github.com/cranberriez/discord.ts-bot-template",
+		"branch": "main",
+		"commit": "bb6934973ff4c505d9fde2466c2d4471b0e5069b",
+		"stars": 0
+	},
+	"files": [
+		".gitignore",
+		"README.md",
+		"bun.lock",
+		"config.example.jsonc",
+		"eslint.config.js",
+		"package.json",
+		"pnpm-lock.yaml",
+		"src/index.ts",
+		"tsconfig.json"
+	],
+	"contents": {
+		"package.json": "{\n    \"name\": \"calendar-bot\",\n    \"version\": \"1.0.0\",\n    \"description\": \"Discord event management bot using Bun, TypeScript, and discord.js\",\n    \"license\": \"ISC\",\n    \"author\": \"Jacob\",\n    \"type\": \"module\",\n    \"main\": \"src/index.ts\",\n    \"scripts\": {\n        \"dev\": \"bun --hot run src/index.ts\",\n        \"start\": \"bun run src/index.ts\",\n        \"deploy\": \"bun run scripts/deploy-commands.ts\",\n        \"lint\": \"eslint .\",\n        \"type-check\": \"tsc --noEmit\"\n    },\n    \"dependencies\": {\n        \"discord.js\": \"^14.26.4\"\n    },\n    \"devDependencies\": {\n        \"@discordjs/rest\": \"^2.5.0\",\n        \"@eslint/js\": \"^9.0.0\",\n        \"@types/bun\": \"^1.1.0\",\n        \"@typescript-eslint/eslint-plugin\": \"^7.0.0\",\n        \"@typescript-eslint/parser\": \"^7.0.0\",\n        \"eslint\": \"^9.0.0\",\n        \"typescript\": \"^5.4.0\"\n    }\n}\n"
+	},
+	"expected": {
+		"runtime": "node",
+		"packageManager": "pnpm",
+		"framework": "discord-js",
+		"platform": "discord",
+		"install": "corepack pnpm install --frozen-lockfile",
+		"build": null,
+		"start": "bun run src/index.ts",
+		"nodeVersion": null,
+		"pythonVersion": null,
+		"tokenKey": null,
+		"warnings": []
+	}
+}

package/src/bot/detect/corpus/crazycat256-nextcord-bot-template.json

@@ -0,0 +1,38 @@
+{
+	"source": {
+		"url": "https://github.com/crazycat256/Nextcord-Bot-Template",
+		"branch": "main",
+		"commit": "661cd8cf6f2c7cc43dea2e18c866e3bd25e08a8e",
+		"stars": 5
+	},
+	"files": [
+		".env.example",
+		".gitattributes",
+		".gitignore",
+		"LICENSE",
+		"README.md",
+		"bot.py",
+		"config.py",
+		"main.py",
+		"requirements.txt"
+	],
+	"contents": {
+		".env.example": "TOKEN = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX # your token here",
+		"requirements.txt": "nextcord\npython-dotenv"
+	},
+	"expected": {
+		"runtime": "python",
+		"packageManager": "pip",
+		"framework": "nextcord",
+		"platform": "discord",
+		"install": "uv pip install -r requirements.txt",
+		"build": null,
+		"start": "python main.py",
+		"nodeVersion": null,
+		"pythonVersion": null,
+		"tokenKey": "TOKEN",
+		"warnings": [
+			"unpinned-requirements"
+		]
+	}
+}