@kamaras/venpm 0.0.1 → 0.1.0

package/dist/core/registry.js

@@ -0,0 +1,134 @@
+import { getCachedEntry, setCachedEntry } from "./cache.js";
+/**
+ * Fetch a single plugin index from `url` using `http`.
+ * If a cached entry is provided, sends conditional request headers.
+ * On 304 Not Modified, returns the cached body.
+ * On 200, updates the cache entry with new ETag/Last-Modified.
+ * Throws on HTTP error or invalid JSON.
+ */
+export async function fetchIndex(http, url, options) {
+    const cached = options?.cached;
+    const headers = {};
+    if (cached?.etag) {
+        headers["If-None-Match"] = cached.etag;
+    }
+    if (cached?.lastModified) {
+        headers["If-Modified-Since"] = cached.lastModified;
+    }
+    const response = await http.fetch(url, Object.keys(headers).length > 0 ? { headers } : undefined);
+    // 304 Not Modified — use cached body
+    if (response.status === 304 && cached) {
+        let parsed;
+        try {
+            parsed = JSON.parse(cached.body);
+        }
+        catch {
+            throw new Error(`Invalid JSON in cache for ${url}`);
+        }
+        return { index: parsed };
+    }
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} fetching ${url}`);
+    }
+    const text = await response.text();
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Invalid JSON from ${url}`);
+    }
+    // Build updated cache entry from response headers
+    const etag = response.headers?.get("etag") ?? response.headers?.get("ETag") ?? undefined;
+    const lastModified = response.headers?.get("last-modified") ?? response.headers?.get("Last-Modified") ?? undefined;
+    const updatedEntry = {
+        url,
+        etag: etag ?? undefined,
+        lastModified: lastModified ?? undefined,
+        body: text,
+        cachedAt: new Date().toISOString(),
+    };
+    return { index: parsed, updatedEntry };
+}
+/**
+ * Fetch all indexes in parallel, capturing errors into FetchedIndex.error (never throwing).
+ * Accepts an optional cache; returns an updated cache with any new/refreshed entries.
+ */
+export async function fetchAllIndexes(http, repos, options) {
+    const inputCache = options?.cache ?? { entries: {} };
+    const pairs = await Promise.all(repos.map(async (repo) => {
+        const cached = getCachedEntry(inputCache, repo.url);
+        try {
+            const result = await fetchIndex(http, repo.url, cached ? { cached } : undefined);
+            return {
+                fi: { repoName: repo.name, index: result.index },
+                updatedEntry: result.updatedEntry,
+                url: repo.url,
+            };
+        }
+        catch (err) {
+            return {
+                fi: {
+                    repoName: repo.name,
+                    error: err instanceof Error ? err.message : String(err),
+                },
+                url: repo.url,
+            };
+        }
+    }));
+    let updatedCache = inputCache;
+    for (const { updatedEntry, url } of pairs) {
+        if (updatedEntry) {
+            updatedCache = setCachedEntry(updatedCache, url, updatedEntry);
+        }
+    }
+    return {
+        results: pairs.map(p => p.fi),
+        updatedCache,
+    };
+}
+/**
+ * Find a plugin by name across fetched indexes.
+ * If `fromRepo` is given, only that repo is searched.
+ * Returns `undefined` when not found.
+ */
+export function resolvePlugin(indexes, pluginName, fromRepo) {
+    const candidates = fromRepo
+        ? indexes.filter(fi => fi.repoName === fromRepo)
+        : indexes;
+    for (const fi of candidates) {
+        if (!fi.index)
+            continue;
+        const entry = fi.index.plugins[pluginName];
+        if (entry) {
+            return { name: pluginName, repoName: fi.repoName, entry };
+        }
+    }
+    return undefined;
+}
+/**
+ * Fuzzy search plugins by name and description across all fetched indexes.
+ * Name matches are returned before description-only matches.
+ * Case-insensitive substring match.
+ */
+export function searchPlugins(indexes, query) {
+    const q = query.toLowerCase();
+    const nameMatches = [];
+    const descMatches = [];
+    for (const fi of indexes) {
+        if (!fi.index)
+            continue;
+        for (const [name, entry] of Object.entries(fi.index.plugins)) {
+            const nameHit = name.toLowerCase().includes(q);
+            const descHit = entry.description?.toLowerCase().includes(q) ?? false;
+            if (nameHit) {
+                nameMatches.push({ name, repoName: fi.repoName, entry });
+            }
+            else if (descHit) {
+                descMatches.push({ name, repoName: fi.repoName, entry });
+            }
+        }
+    }
+    return [...nameMatches, ...descMatches];
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"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"}

package/dist/core/resolver.d.ts

@@ -0,0 +1,47 @@
+import type { FetchMethod, InstallPlan, LockfileData, PluginEntry, PluginIndex } from "./types.js";
+export declare class ResolverError extends Error {
+    constructor(message: string);
+}
+export interface ResolveOptions {
+    gitAvailable: boolean;
+    forceMethod?: FetchMethod;
+    version?: string;
+    fromRepo?: string;
+}
+/**
+ * Find a plugin by name across all indexes, optionally filtered by repo name.
+ * Returns the first match found. If `fromRepo` is given, only that repo is searched.
+ */
+export declare function findPlugin(indexes: PluginIndex[], name: string, fromRepo?: string): {
+    repoName: string;
+    entry: PluginEntry;
+} | null;
+/**
+ * Resolve a version string for a plugin entry.
+ *
+ * - No constraint → return the entry's latest `version` field.
+ * - Constraint provided → look up in the entry's `versions` map and return it.
+ * - Version not found → throw ResolverError.
+ */
+export declare function resolveVersion(entry: PluginEntry, constraint?: string): string;
+/**
+ * Build a topologically-sorted install order for `pluginName` and all its
+ * transitive dependencies. Circular dependencies are detected and will throw
+ * a ResolverError. Missing dependencies also throw.
+ *
+ * Returns an array of plugin names in dependency-first order (deps before dependents).
+ */
+export declare function buildDependencyGraph(indexes: PluginIndex[], pluginName: string): string[];
+export declare function selectMethodFromSource(source: PluginEntry["source"], gitAvailable: boolean): FetchMethod;
+/**
+ * Collect optional dependencies that are not currently installed.
+ * These are surfaced as warnings, not auto-installed.
+ */
+export declare function collectMissingOptionalDeps(indexes: PluginIndex[], pluginName: string, lockfile: LockfileData): string[];
+/**
+ * Generate a full install plan for `pluginName`, resolving dependencies and
+ * skipping already-installed plugins. Returns an InstallPlan with entries in
+ * dependency-first order, plus any missing optional deps as warnings.
+ */
+export declare function generateInstallPlan(indexes: PluginIndex[], pluginName: string, lockfile: LockfileData, options: ResolveOptions): InstallPlan;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/core/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/core/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,WAAW,EACX,WAAW,EAEX,YAAY,EACZ,WAAW,EACX,WAAW,EACd,MAAM,YAAY,CAAC;AAIpB,qBAAa,aAAc,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI9B;AAID,MAAM,WAAW,cAAc;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;GAGG;AACH,wBAAgB,UAAU,CACtB,OAAO,EAAE,WAAW,EAAE,EACtB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAClB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAQjD;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAW9E;AAID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BzF;AAID,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC7B,YAAY,EAAE,OAAO,GACtB,WAAW,CAOb;AA+BD;;;GAGG;AACH,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,GACvB,MAAM,EAAE,CAMV;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,cAAc,GACxB,WAAW,CAqCb"}

package/dist/core/resolver.js

@@ -0,0 +1,153 @@
+// ─── Errors ───────────────────────────────────────────────────────────────────
+export class ResolverError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ResolverError";
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Find a plugin by name across all indexes, optionally filtered by repo name.
+ * Returns the first match found. If `fromRepo` is given, only that repo is searched.
+ */
+export function findPlugin(indexes, name, fromRepo) {
+    for (const index of indexes) {
+        if (fromRepo !== undefined && index.name !== fromRepo)
+            continue;
+        if (Object.prototype.hasOwnProperty.call(index.plugins, name)) {
+            return { repoName: index.name, entry: index.plugins[name] };
+        }
+    }
+    return null;
+}
+// ─── Version Resolution ───────────────────────────────────────────────────────
+/**
+ * Resolve a version string for a plugin entry.
+ *
+ * - No constraint → return the entry's latest `version` field.
+ * - Constraint provided → look up in the entry's `versions` map and return it.
+ * - Version not found → throw ResolverError.
+ */
+export function resolveVersion(entry, constraint) {
+    if (constraint === undefined || constraint === null) {
+        return entry.version;
+    }
+    const versions = entry.versions ?? {};
+    if (!Object.prototype.hasOwnProperty.call(versions, constraint)) {
+        throw new ResolverError(`Version "${constraint}" not found. Available versions: ${Object.keys(versions).join(", ") || "(none)"}`);
+    }
+    return constraint;
+}
+// ─── Dependency Graph ─────────────────────────────────────────────────────────
+/**
+ * Build a topologically-sorted install order for `pluginName` and all its
+ * transitive dependencies. Circular dependencies are detected and will throw
+ * a ResolverError. Missing dependencies also throw.
+ *
+ * Returns an array of plugin names in dependency-first order (deps before dependents).
+ */
+export function buildDependencyGraph(indexes, pluginName) {
+    const order = [];
+    const visited = new Set();
+    const inStack = new Set();
+    function visit(name) {
+        if (inStack.has(name)) {
+            throw new ResolverError(`Circular dependency detected involving "${name}"`);
+        }
+        if (visited.has(name))
+            return;
+        inStack.add(name);
+        const found = findPlugin(indexes, name);
+        if (!found) {
+            throw new ResolverError(`Dependency "${name}" not found in any index`);
+        }
+        const deps = found.entry.dependencies ?? [];
+        for (const dep of deps) {
+            visit(dep);
+        }
+        inStack.delete(name);
+        visited.add(name);
+        order.push(name);
+    }
+    visit(pluginName);
+    return order;
+}
+// ─── Method Selection ─────────────────────────────────────────────────────────
+export function selectMethodFromSource(source, gitAvailable) {
+    if (gitAvailable && source.git)
+        return "git";
+    if (source.tarball)
+        return "tarball";
+    if (source.local)
+        return "local";
+    throw new ResolverError(`No suitable fetch method available (git available: ${gitAvailable}, source: ${JSON.stringify(source)})`);
+}
+function selectMethod(entry, gitAvailable, forceMethod) {
+    const { source } = entry;
+    if (forceMethod !== undefined) {
+        // Validate that the forced method is actually available
+        if (forceMethod === "git" && source.git)
+            return "git";
+        if (forceMethod === "tarball" && source.tarball)
+            return "tarball";
+        if (forceMethod === "local" && source.local)
+            return "local";
+        throw new ResolverError(`Forced method "${forceMethod}" is not available for this plugin (source has: ${Object.keys(source).join(", ")})`);
+    }
+    // Default selection: git > tarball > local
+    if (gitAvailable && source.git)
+        return "git";
+    if (source.tarball)
+        return "tarball";
+    if (source.local)
+        return "local";
+    throw new ResolverError(`No suitable fetch method available for plugin (git available: ${gitAvailable}, source: ${JSON.stringify(source)})`);
+}
+// ─── Install Plan ─────────────────────────────────────────────────────────────
+/**
+ * Collect optional dependencies that are not currently installed.
+ * These are surfaced as warnings, not auto-installed.
+ */
+export function collectMissingOptionalDeps(indexes, pluginName, lockfile) {
+    const found = findPlugin(indexes, pluginName);
+    if (!found)
+        return [];
+    const optDeps = found.entry.optionalDependencies ?? [];
+    return optDeps.filter(dep => !Object.prototype.hasOwnProperty.call(lockfile.installed, dep));
+}
+/**
+ * Generate a full install plan for `pluginName`, resolving dependencies and
+ * skipping already-installed plugins. Returns an InstallPlan with entries in
+ * dependency-first order, plus any missing optional deps as warnings.
+ */
+export function generateInstallPlan(indexes, pluginName, lockfile, options) {
+    const order = buildDependencyGraph(indexes, pluginName);
+    const entries = [];
+    for (const name of order) {
+        const alreadyInstalled = Object.prototype.hasOwnProperty.call(lockfile.installed, name);
+        if (alreadyInstalled)
+            continue;
+        const found = findPlugin(indexes, name, options.fromRepo);
+        // findPlugin without fromRepo will never return null here since buildDependencyGraph
+        // already validated all deps, but we fall back to searching all indexes.
+        const result = found ?? findPlugin(indexes, name);
+        const { repoName, entry } = result;
+        // For the root plugin, apply the version constraint; deps get their latest.
+        const constraint = name === pluginName ? options.version : undefined;
+        const version = resolveVersion(entry, constraint);
+        const method = selectMethod(entry, options.gitAvailable, options.forceMethod);
+        const isDependency = name !== pluginName;
+        entries.push({
+            name,
+            version,
+            repo: repoName,
+            source: entry.source,
+            method,
+            isDependency,
+            versionEntry: entry.versions?.[version],
+        });
+    }
+    const missingOptional = collectMissingOptionalDeps(indexes, pluginName, lockfile);
+    return { entries, missingOptional };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/core/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/core/resolver.ts"],"names":[],"mappings":"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"}

package/dist/core/schema.d.ts

@@ -0,0 +1,8 @@
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateIndex(data: unknown): ValidationResult;
+export declare function validateConfig(data: unknown): ValidationResult;
+export declare function validateLockfile(data: unknown): ValidationResult;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AA8BD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAE7D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAEhE"}

package/dist/core/schema.js

@@ -0,0 +1,47 @@
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+import Ajv2020Module from "ajv/dist/2020.js";
+import addFormatsModule from "ajv-formats";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+// Handle CJS/ESM interop
+const Ajv2020 = Ajv2020Module.default ?? Ajv2020Module;
+const addFormats = addFormatsModule.default ?? addFormatsModule;
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const schemasDir = join(__dirname, "..", "..", "schemas", "v1");
+function createValidator() {
+    // @ts-expect-error — ajv CJS/ESM interop
+    const ajv = new Ajv2020({ allErrors: true });
+    // @ts-expect-error — ajv-formats CJS/ESM interop
+    addFormats(ajv);
+    return ajv;
+}
+function loadSchema(filename) {
+    const raw = readFileSync(join(schemasDir, filename), "utf-8");
+    return JSON.parse(raw);
+}
+function validate(data, schemaFile) {
+    if (data === null || data === undefined) {
+        return { valid: false, errors: ["Input is null or undefined"] };
+    }
+    const ajv = createValidator();
+    const schema = loadSchema(schemaFile);
+    const valid = ajv.validate(schema, data);
+    if (valid)
+        return { valid: true, errors: [] };
+    const errors = (ajv.errors ?? []).map((e) => {
+        const path = e.instancePath || "/";
+        return `${path}: ${e.message}`;
+    });
+    return { valid: false, errors };
+}
+export function validateIndex(data) {
+    return validate(data, "plugins.schema.json");
+}
+export function validateConfig(data) {
+    return validate(data, "config.schema.json");
+}
+export function validateLockfile(data) {
+    return validate(data, "lockfile.schema.json");
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,gBAAgB,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,yBAAyB;AACzB,MAAM,OAAO,GAAI,aAAkD,CAAC,OAAO,IAAI,aAAa,CAAC;AAC7F,MAAM,UAAU,GAAI,gBAAqD,CAAC,OAAO,IAAI,gBAAgB,CAAC;AAEtG,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAOhE,SAAS,eAAe;IACpB,yCAAyC;IACzC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,iDAAiD;IACjD,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAChC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAa,EAAE,UAAkB;IAC/C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,4BAA4B,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAA8C,EAAE,EAAE;QACrF,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,GAAG,CAAC;QACnC,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACvC,OAAO,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa;IACxC,OAAO,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC1C,OAAO,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;AAClD,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,206 @@
+export interface PluginAuthor {
+    name: string;
+    id: string;
+}
+/** Source location for a plugin — at least one of git/tarball must be present. */
+export interface PluginSource {
+    /** Git repository URL */
+    git?: string;
+    /** Path within the git repo to the plugin folder */
+    path?: string;
+    /** Direct tarball download URL */
+    tarball?: string;
+    /** Local filesystem path (for development / local repos) */
+    local?: string;
+}
+export interface VersionEntry {
+    git_tag?: string;
+    tarball?: string;
+}
+export interface PluginEntry {
+    version: string;
+    description: string;
+    authors: PluginAuthor[];
+    license?: string;
+    dependencies?: string[];
+    optionalDependencies?: string[];
+    /** Semver range for required Discord build */
+    discord?: string;
+    /** Semver range for required Vencord version */
+    vencord?: string;
+    source: PluginSource;
+    /** Named version history (version string → VersionEntry) */
+    versions?: Record<string, VersionEntry>;
+}
+export interface PluginIndex {
+    name: string;
+    description?: string;
+    /** Plugin name → PluginEntry */
+    plugins: Record<string, PluginEntry>;
+}
+/** How venpm handles rebuilding Vencord after install/remove */
+export type RebuildMode = "ask" | "always" | "never";
+/** How venpm handles restarting Discord */
+export type RestartMode = "ask" | "always" | "never";
+export interface RepoEntry {
+    name: string;
+    url: string;
+}
+export interface Config {
+    repos: RepoEntry[];
+    vencord: {
+        /** Absolute path to the Vencord source checkout, or null if not yet configured */
+        path: string | null;
+    };
+    rebuild: RebuildMode;
+    discord: {
+        restart: RestartMode;
+        /** Path to the Discord binary, or null to auto-detect */
+        binary: string | null;
+    };
+}
+export type FetchMethod = "git" | "tarball" | "local";
+export interface InstalledPlugin {
+    version: string;
+    repo: string;
+    method: FetchMethod;
+    pinned: boolean;
+    /** Git commit hash (when method === "git") */
+    git_ref?: string;
+    installed_at: string;
+    /** Override path relative to userplugins dir */
+    path?: string;
+}
+export interface LockfileData {
+    installed: Record<string, InstalledPlugin>;
+}
+export interface InstallPlanEntry {
+    name: string;
+    version: string;
+    repo: string;
+    source: PluginSource;
+    method: FetchMethod;
+    /** True if this entry was added to satisfy a dependency */
+    isDependency: boolean;
+    /** Current installed version, if upgrading */
+    currentVersion?: string;
+    /** Version metadata from the index (git_tag, tarball URL) */
+    versionEntry?: VersionEntry;
+}
+export interface InstallPlan {
+    entries: InstallPlanEntry[];
+    /** Optional deps that aren't installed — surfaced as warnings */
+    missingOptional?: string[];
+}
+export interface FileSystem {
+    readFile(path: string, encoding: BufferEncoding): Promise<string>;
+    writeFile(path: string, data: string, encoding?: BufferEncoding): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rm(path: string, options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    symlink(target: string, path: string): Promise<void>;
+    readlink(path: string): Promise<string>;
+    readdir(path: string): Promise<string[]>;
+    stat(path: string): Promise<{
+        isDirectory(): boolean;
+        isFile(): boolean;
+        size: number;
+    }>;
+    lstat(path: string): Promise<{
+        isDirectory(): boolean;
+        isFile(): boolean;
+        isSymbolicLink(): boolean;
+    }>;
+    copyDir(src: string, dest: string): Promise<void>;
+}
+export interface HttpResponseHeaders {
+    get(name: string): string | null;
+}
+export interface HttpClient {
+    fetch(url: string, options?: {
+        headers?: Record<string, string>;
+    }): Promise<{
+        ok: boolean;
+        status: number;
+        headers?: HttpResponseHeaders;
+        text(): Promise<string>;
+        json(): Promise<unknown>;
+        arrayBuffer(): Promise<ArrayBuffer>;
+    }>;
+}
+export interface GitClient {
+    available(): Promise<boolean>;
+    clone(url: string, dest: string, options?: {
+        sparse?: string[];
+        branch?: string;
+        depth?: number;
+    }): Promise<void>;
+    pull(repoPath: string): Promise<void>;
+    revParse(repoPath: string, ref: string): Promise<string>;
+    checkout(repoPath: string, ref: string): Promise<void>;
+}
+export interface ShellRunner {
+    exec(cmd: string, args: string[], options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    spawn(cmd: string, args: string[], options?: {
+        cwd?: string;
+        detached?: boolean;
+        env?: Record<string, string>;
+    }): Promise<void>;
+}
+export interface Prompter {
+    confirm(message: string, defaultValue?: boolean): Promise<boolean>;
+    input(message: string, defaultValue?: string): Promise<string>;
+    select<T extends string>(message: string, choices: {
+        value: T;
+        label: string;
+    }[]): Promise<T>;
+}
+export interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    verbose(message: string): void;
+    success(message: string): void;
+}
+export interface IOContext {
+    fs: FileSystem;
+    http: HttpClient;
+    git: GitClient;
+    shell: ShellRunner;
+    prompter: Prompter;
+    logger: Logger;
+}
+export interface GlobalOptions {
+    config?: string;
+    verbose?: boolean;
+    json?: boolean;
+}
+export interface InstallOptions extends GlobalOptions {
+    version?: string;
+    from?: string;
+    local?: string;
+    git?: boolean;
+    tarball?: boolean;
+    noBuild?: boolean;
+    rebuild?: boolean;
+}
+export interface CreateOptions extends GlobalOptions {
+    output?: string;
+    force?: boolean;
+}
+export interface ValidateOptions extends GlobalOptions {
+    strict?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -0,0 +1,3 @@
+// ─── Plugin Index (plugins.json) ─────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,gFAAgF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}