@creeperhost/modlens-mcp 1.6.0

package/dist/tools/modpacks-ch.d.ts

@@ -0,0 +1,257 @@
+type PackNamespace = "ftb" | "curseforge";
+export interface SyncPackModsOptions {
+    packId: number;
+    versionId: number;
+    namespace: PackNamespace;
+    /** Only ingest files matching these types (default: ["mod", "resource"]). */
+    fileTypes?: string[];
+    /** Skip files that are server-only (default: false). */
+    skipServer?: boolean;
+    /** Skip optional files (default: false). */
+    skipOptional?: boolean;
+    /** Maximum number of mods to ingest concurrently (default: 3). */
+    concurrency?: number;
+}
+interface FileResult {
+    name: string;
+    type: string;
+    fileId?: number;
+    status: string;
+    dbId?: number;
+    message?: string;
+}
+export declare function searchPacksAction(term: string, namespace?: PackNamespace, limit?: number): Promise<{
+    ftbPacks: never[];
+    cfPacks: never[];
+    total: number;
+    note?: undefined;
+} | {
+    ftbPacks: number[];
+    cfPacks: number[];
+    total: number;
+    note: string;
+}>;
+export declare function featuredPacksAction(limit?: number): Promise<{
+    packs: number[];
+    total: number;
+}>;
+export declare function packInfoAction(packId: number, namespace?: PackNamespace): Promise<{
+    id: number;
+    name: string;
+    synopsis: string;
+    provider: string;
+    installs: number;
+    tags: string[];
+    authors: {
+        name: string;
+        type: string;
+    }[];
+    links: {
+        type: string;
+        url: string;
+    }[];
+    versions: {
+        id: number;
+        name: string;
+        type: string;
+        targets: {
+            name: string;
+            version: string;
+        }[];
+        updated: string;
+    }[];
+}>;
+export declare function packManifestAction(packId: number, versionId: number, namespace?: PackNamespace): Promise<{
+    id: number;
+    parent: number;
+    name: string;
+    version: string;
+    type: string;
+    targets: {
+        name: string;
+        version: string;
+    }[];
+    fileCount: number;
+    byType: {
+        [k: string]: number;
+    };
+    files: {
+        id: number;
+        name: string;
+        type: string;
+        path: string;
+        size: number;
+        sha1: string | null;
+        clientonly: boolean;
+        serveronly: boolean;
+        optional: boolean;
+        hasCdnUrl: boolean;
+        cfProject: number | null;
+        cfFile: number | null;
+    }[];
+}>;
+export declare function searchFtbModsAction(term: string, limit?: number): Promise<{
+    total: number;
+    mods: (string | number)[];
+    enriched: {
+        id: string | number;
+        name: string;
+        synopsis: string;
+        installs: number;
+        links: {
+            type: string;
+            url: string;
+        }[];
+    }[];
+}>;
+export declare function ftbModInfoAction(modId: number | string, opts?: {
+    mcVersion?: string;
+    loader?: string;
+}): Promise<{
+    id: string | number;
+    name: string;
+    synopsis: string;
+    installs: number;
+    links: {
+        type: string;
+        url: string;
+    }[];
+    versions: {
+        fileId: number;
+        name: string;
+        version: string;
+        type: string;
+        size: number;
+        sha1: string | null;
+        url: string | null;
+        mcVersions: string[];
+        loaders: string[];
+        updated: string;
+    }[];
+}>;
+/**
+ * Download and ingest a single mod JAR from the modpacks.ch CDN.
+ * No CF API key required.
+ *
+ * @param modId    - CF project ID (integer) or Modrinth slug/ID (string)
+ * @param opts.mcVersion - Filter to versions for this MC version
+ * @param opts.loader    - Filter to versions for this loader (neoforge, fabric, etc.)
+ * @param opts.fileId    - Exact CF file ID to download (skip filtering)
+ * @param opts.force     - Re-download even if the file is already in cache
+ */
+export declare function downloadModAction(modId: number | string, opts?: {
+    mcVersion?: string;
+    loader?: string;
+    fileId?: number;
+    force?: boolean;
+}): Promise<{
+    status: string;
+    modId?: number;
+    name?: string;
+    version?: string;
+    jarPath?: string;
+    message?: string;
+}>;
+/**
+ * Download and ingest every mod (and optionally resource/datapack) from a
+ * modpack manifest into the ModLens database.
+ *
+ * Works for both FTB packs and CurseForge packs via the modpacks.ch API —
+ * no CurseForge API key required.
+ */
+export declare function syncPackModsAction(opts: SyncPackModsOptions): Promise<{
+    packId: number;
+    versionId: number;
+    namespace: string;
+    packVersionDbId: number;
+    total: number;
+    ingested: number;
+    skipped: number;
+    failed: number;
+    files: FileResult[];
+}>;
+/** List all pack versions recorded in the DB, optionally filtered by namespace / packId. */
+export declare function listPackVersionsAction(namespace?: string, packId?: number): Promise<{
+    total: number;
+    versions: {
+        dbId: number;
+        namespace: string;
+        packId: number;
+        versionId: number;
+        packName: string;
+        versionName: string;
+        mcVersion: string | null;
+        modloader: string | null;
+        syncedAt: Date;
+    }[];
+}>;
+/**
+ * List all files recorded for a specific pack version.
+ * Look up the version by either its DB id (packVersionDbId) or
+ * the (namespace + packId + versionId) triple.
+ */
+export declare function listPackFilesAction(opts: {
+    packVersionDbId?: number;
+    namespace?: string;
+    packId?: number;
+    versionId?: number;
+    fileType?: string;
+}): Promise<{
+    packVersionDbId: number;
+    total: number;
+    byType: {
+        [k: string]: number;
+    };
+    files: {
+        id: number;
+        manifestFileId: number | null;
+        fileType: string;
+        fileName: string;
+        filePath: string | null;
+        cfProject: number | null;
+        cfFile: number | null;
+        sha1: string | null;
+        status: string;
+        modId: number | null;
+    }[];
+}>;
+/**
+ * Find every pack version that contains a given mod.
+ * Accepts a ModLens DB mod id (modDbId) or a CurseForge project id (cfProject).
+ */
+export declare function findModInPacksAction(opts: {
+    modDbId?: number;
+    cfProject?: number;
+}): Promise<{
+    modDbId: number;
+    packs: import("../repositories/packs.js").PackMembership[];
+    cfProject?: undefined;
+} | {
+    cfProject: number;
+    packs: import("../repositories/packs.js").PackMembership[];
+    modDbId?: undefined;
+}>;
+/**
+ * Download and extract the overrides ZIP (KubeJS scripts, configs, defaultconfigs,
+ * resource overrides, etc.) for a CurseForge pack version.
+ *
+ * The overrides are extracted to:
+ *   CACHE_ROOT/packs/curseforge/{packId}/{versionId}/overrides/
+ *
+ * The corresponding PackFile record is updated to status "extracted".
+ */
+export declare function downloadOverridesAction(opts: {
+    namespace: string;
+    packId: number;
+    versionId: number;
+    force?: boolean;
+}): Promise<{
+    status: string;
+    zipPath: string;
+    extractDir: string;
+    fileCount: number;
+    topDirs: string[];
+    url: string;
+}>;
+export {};
+//# sourceMappingURL=modpacks-ch.d.ts.map

package/dist/tools/modpacks-ch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modpacks-ch.d.ts","sourceRoot":"","sources":["../../src/tools/modpacks-ch.ts"],"names":[],"mappings":"AAgDA,KAAK,aAAa,GAAG,KAAK,GAAG,YAAY,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAO,MAAM,CAAC;IACpB,SAAS,EAAI,MAAM,CAAC;IACpB,SAAS,EAAI,aAAa,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,CAAC,EAAG,MAAM,EAAE,CAAC;IACtB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,UAAU;IAChB,IAAI,EAAO,MAAM,CAAC;IAClB,IAAI,EAAO,MAAM,CAAC;IAClB,MAAM,CAAC,EAAI,MAAM,CAAC;IAClB,MAAM,EAAK,MAAM,CAAC;IAClB,IAAI,CAAC,EAAM,MAAM,CAAC;IAClB,OAAO,CAAC,EAAG,MAAM,CAAC;CACrB;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,aAAqB,EAAE,KAAK,SAAK;;;;;;;;;;GAgBjG;AAED,wBAAsB,mBAAmB,CAAC,KAAK,SAAK;;;GAInD;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,aAAqB;;;;;;;;;;;;;;;;;;;;;;;;;GAwBpF;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,aAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsC3G;AAID,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK;;;;;;;;;;;;;GAmBjE;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,GAAE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAClC;;;;;;;;;;;;;;;;;;;;;GAqCL;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,GAAE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CACpE,GAAG,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CA8DD;AAID;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;IACzE,MAAM,EAAW,MAAM,CAAC;IACxB,SAAS,EAAQ,MAAM,CAAC;IACxB,SAAS,EAAQ,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAY,MAAM,CAAC;IACxB,QAAQ,EAAS,MAAM,CAAC;IACxB,OAAO,EAAU,MAAM,CAAC;IACxB,MAAM,EAAW,MAAM,CAAC;IACxB,KAAK,EAAY,UAAU,EAAE,CAAC;CACjC,CAAC,CAqFD;AAmDD,4FAA4F;AAC5F,wBAAsB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;;;;;;;;;;;;;GAgB/E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;;;;;;;;;;;;;;;;;;GAkCA;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;GAUxF;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAChD,SAAS,EAAG,MAAM,CAAC;IACnB,MAAM,EAAM,MAAM,CAAC;IACnB,SAAS,EAAG,MAAM,CAAC;IACnB,KAAK,CAAC,EAAM,OAAO,CAAC;CACvB;;;;;;;GAsEA"}