@kamaras/venpm 0.0.1 → 0.1.1

package/dist/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { Command } from "commander";
+import { registerInstallCommand } from "./cli/install.js";
+import { registerUninstallCommand } from "./cli/uninstall.js";
+import { registerUpdateCommand } from "./cli/update.js";
+import { registerListCommand } from "./cli/list.js";
+import { registerSearchCommand } from "./cli/search.js";
+import { registerInfoCommand } from "./cli/info.js";
+import { registerRepoCommand } from "./cli/repo.js";
+import { registerConfigCommand } from "./cli/config-cmd.js";
+import { registerCreateCommand } from "./cli/create.js";
+import { registerRebuildCommand } from "./cli/rebuild.js";
+import { registerDoctorCommand } from "./cli/doctor.js";
+import { registerValidateCommand } from "./cli/validate.js";
+const _require = createRequire(import.meta.url);
+const { version } = _require("../package.json");
+const program = new Command();
+program
+    .name("venpm")
+    .description("Vencord Plugin Manager — install and manage userplugins")
+    .version(version)
+    .option("-y, --yes", "Automatically answer yes to all prompts")
+    .option("--verbose", "Enable verbose output")
+    .option("--quiet", "Suppress non-essential output")
+    .option("--json", "Output structured JSON instead of human-readable text");
+registerInstallCommand(program);
+registerUninstallCommand(program);
+registerUpdateCommand(program);
+registerListCommand(program);
+registerSearchCommand(program);
+registerInfoCommand(program);
+registerRepoCommand(program);
+registerConfigCommand(program);
+registerCreateCommand(program);
+registerRebuildCommand(program);
+registerDoctorCommand(program);
+registerValidateCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,iBAAiB,CAAwB,CAAC;AAEvE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,WAAW,EAAE,yCAAyC,CAAC;KAC9D,MAAM,CAAC,WAAW,EAAE,uBAAuB,CAAC;KAC5C,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;KAClD,MAAM,CAAC,QAAQ,EAAE,uDAAuD,CAAC,CAAC;AAE/E,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAEjC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/package.json

@@ -1,12 +1,48 @@
 {
   "name": "@kamaras/venpm",
-  "version": "0.0.1",
-  "description": "Vencord Plugin Manager — install and manage userplugins from JSON indexes",
-  "keywords": ["vencord", "discord", "plugin", "manager"],
+  "version": "0.1.1",
+  "description": "Vencord Plugin Manager — CLI and index spec for distributing userplugins",
+  "type": "module",
+  "bin": {
+    "venpm": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "setup": "npm install && npm run build && npm link",
+    "unsetup": "npm unlink -g venpm"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "schemas/",
+    "actions/"
+  ],
+  "keywords": [
+    "vencord",
+    "discord",
+    "plugin",
+    "userplugin",
+    "package-manager"
+  ],
   "author": "kamaras",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/theokyr/venpm"
+  "publishConfig": { "access": "public" },
+  "dependencies": {
+    "ajv": "^8.17.0",
+    "ajv-formats": "^3.0.1",
+    "commander": "^13.0.0",
+    "tar": "^7.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.0"
   }
 }

package/schemas/v1/config.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://venpm.dev/schemas/v1/config.json",
+  "title": "venpm Config",
+  "description": "User configuration for venpm, the Vencord Plugin Manager",
+  "type": "object",
+  "required": ["repos", "vencord", "rebuild", "discord"],
+  "properties": {
+    "$schema": { "type": "string", "description": "JSON Schema URL for IDE validation" },
+    "repos": {
+      "type": "array",
+      "description": "Plugin repository sources",
+      "items": {
+        "type": "object",
+        "required": ["name", "url"],
+        "properties": {
+          "name": { "type": "string", "description": "Repository identifier", "pattern": "^[a-zA-Z0-9_-]+$" },
+          "url": { "type": "string", "format": "uri", "description": "URL to the plugin index JSON" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "vencord": {
+      "type": "object",
+      "description": "Vencord installation settings",
+      "required": ["path"],
+      "properties": {
+        "path": { "type": ["string", "null"], "description": "Path to the Vencord source directory, or null to auto-detect" }
+      },
+      "additionalProperties": false
+    },
+    "rebuild": {
+      "type": "string",
+      "description": "Whether to rebuild Vencord after plugin changes",
+      "enum": ["ask", "always", "never"]
+    },
+    "discord": {
+      "type": "object",
+      "description": "Discord restart settings",
+      "required": ["restart", "binary"],
+      "properties": {
+        "restart": {
+          "type": "string",
+          "description": "Whether to restart Discord after a rebuild",
+          "enum": ["ask", "always", "never"]
+        },
+        "binary": { "type": ["string", "null"], "description": "Path to the Discord binary, or null to auto-detect" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/v1/lockfile.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://venpm.dev/schemas/v1/lockfile.json",
+  "title": "venpm Lockfile",
+  "description": "Lockfile tracking installed plugins for venpm, the Vencord Plugin Manager",
+  "type": "object",
+  "required": ["installed"],
+  "properties": {
+    "$schema": { "type": "string", "description": "JSON Schema URL for IDE validation" },
+    "installed": {
+      "type": "object",
+      "description": "Map of plugin name to installed plugin entry",
+      "additionalProperties": { "$ref": "#/$defs/installedEntry" }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "installedEntry": {
+      "type": "object",
+      "required": ["version", "repo", "method", "pinned", "installed_at"],
+      "properties": {
+        "version": {
+          "description": "Installed version (semver or 'local' for local installs)",
+          "oneOf": [
+            { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-zA-Z0-9.]+)?$" },
+            { "type": "string", "const": "local" }
+          ]
+        },
+        "repo": { "type": "string", "description": "Repository name this plugin was installed from" },
+        "method": {
+          "type": "string",
+          "description": "How the plugin was installed",
+          "enum": ["git", "tarball", "local"]
+        },
+        "pinned": { "type": "boolean", "description": "Whether this plugin is pinned to its current version" },
+        "installed_at": { "type": "string", "format": "date-time", "description": "ISO 8601 timestamp of when the plugin was installed" },
+        "git_ref": { "type": "string", "description": "Git ref (commit SHA, tag, or branch) used for installation" },
+        "path": { "type": "string", "description": "Subdirectory path within the git repo (for monorepos)" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/v1/plugins.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://venpm.dev/schemas/v1/plugins.json",
+  "title": "venpm Plugin Index",
+  "description": "Plugin repository index for venpm, the Vencord Plugin Manager",
+  "type": "object",
+  "required": ["name", "description", "plugins"],
+  "properties": {
+    "$schema": { "type": "string", "description": "JSON Schema URL for IDE validation" },
+    "name": { "type": "string", "description": "Repository identifier", "pattern": "^[a-zA-Z0-9_-]+$" },
+    "description": { "type": "string", "description": "Human-readable repository description" },
+    "plugins": {
+      "type": "object",
+      "description": "Map of plugin name to plugin definition",
+      "additionalProperties": { "$ref": "#/$defs/pluginEntry" }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "pluginEntry": {
+      "type": "object",
+      "required": ["version", "description", "authors", "source"],
+      "properties": {
+        "version": { "type": "string", "description": "Current/latest semver version", "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-zA-Z0-9.]+)?$" },
+        "description": { "type": "string" },
+        "authors": {
+          "type": "array",
+          "items": {
+            "type": "object", "required": ["name", "id"],
+            "properties": { "name": { "type": "string" }, "id": { "type": "string" } },
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "license": { "type": "string", "description": "SPDX license identifier" },
+        "dependencies": { "type": "array", "items": { "type": "string" }, "description": "Required plugins (auto-installed)" },
+        "optionalDependencies": { "type": "array", "items": { "type": "string" }, "description": "Recommended plugins (warned about, not auto-installed)" },
+        "discord": { "type": "string", "description": "Informational Discord version range (never blocks install)" },
+        "vencord": { "type": "string", "description": "Informational Vencord version range (never blocks install)" },
+        "source": { "$ref": "#/$defs/pluginSource" },
+        "versions": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/versionEntry" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "pluginSource": {
+      "type": "object",
+      "description": "Where to fetch the plugin. At least one of git, tarball, or local must be present.",
+      "properties": {
+        "git": { "type": "string", "description": "Git clone URL" },
+        "path": { "type": "string", "description": "Subdirectory within the git repo (for monorepos)" },
+        "tarball": { "type": "string", "format": "uri", "description": "Direct download URL for tarball" },
+        "local": { "type": "string", "description": "Local filesystem path (developer workflow)" }
+      },
+      "anyOf": [{ "required": ["git"] }, { "required": ["tarball"] }, { "required": ["local"] }],
+      "additionalProperties": false
+    },
+    "versionEntry": {
+      "type": "object",
+      "properties": {
+        "git_tag": { "type": "string" },
+        "tarball": { "type": "string", "format": "uri" }
+      },
+      "additionalProperties": false
+    }
+  }
+}