@pipelab/plugin-steam 1.0.0-beta.0

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/utils.ts","../src/upload-to-steam.ts","../src/index.ts"],"sourcesContent":["import { runWithLiveLogs } from \"@pipelab/plugin-core\";\nimport { execa, Options as ExecaOptions } from \"execa\";\nimport os from \"node:os\";\n\nexport type Options = {\n  steamcmdPath: string;\n  username: string;\n  scriptPath: string;\n  context: {\n    log: typeof console.log;\n    abortSignal: AbortSignal;\n  };\n};\n\nexport const checkSteamAuth = async (options: Options) => {\n  let error: \"LOGGED_OUT\" | \"UNKNOWN\" | undefined = undefined;\n\n  try {\n    await runWithLiveLogs(\n      options.steamcmdPath,\n      [\"+login\", options.username, \"+quit\"],\n      {\n        shell: process.platform === \"win32\",\n      },\n      options.context.log,\n      {\n        onStdout: (data, subprocess) => {\n          options.context.log(\"[Steam Cmd]\", data);\n          // TODO: handle password input dynamically\n          if (data.includes(\"Cached credentials not found\")) {\n            error = \"LOGGED_OUT\";\n\n            subprocess.kill();\n          }\n        },\n      },\n      options.context.abortSignal,\n    );\n  } catch (e) {\n    console.error(\"e\", e);\n    if (!error) {\n      error = \"UNKNOWN\";\n    }\n  }\n\n  if (error) {\n    return {\n      success: false,\n      error,\n    };\n  }\n\n  return {\n    success: true,\n  };\n};\n\nexport const openExternalTerminal = async (\n  command: string,\n  args: string[] = [],\n  options: ExecaOptions = {},\n  keepOpen = false,\n) => {\n  const platform = process.platform;\n\n  if (platform === \"darwin\") {\n    // macOS: open in Terminal.app\n    const shellCommand = `${command} ${args.join(\" \")}; echo \"You can now close this window\"`;\n    // Escape for AppleScript string literal\n    const escapedShellCommand = shellCommand\n      .replace(/\\\\/g, \"\\\\\\\\\") // Must escape backslashes first\n      .replace(/\"/g, '\\\\\"'); // Then escape double quotes\n\n    let osaScript: string;\n    if (keepOpen) {\n      // If keepOpen is true, just run the command and leave the terminal open.\n      // Added activate to bring Terminal to front.\n      osaScript = `tell application \"Terminal\"\\nactivate\\ndo script \"${escapedShellCommand}\"\\nend tell`;\n    } else {\n      // If keepOpen is false (default), run the command, wait for it to finish, then close the tab.\n      osaScript = `tell application \"Terminal\"\n    activate\n    set targetTab to do script \"${escapedShellCommand}\"\n    -- Wait for the command to complete by checking the 'busy' status of the tab\n    delay 0.5 -- Initial delay to allow the process to start and tab to become busy\n    repeat while busy of targetTab\n        delay 0.5 -- Check every 0.5 seconds\n    end repeat\nend tell`;\n    }\n\n    return execa(\"osascript\", [\"-e\", osaScript], options);\n  } else if (platform === \"linux\") {\n    // Linux: use $TERMINAL, $TERM, or fallback to xterm\n    const terminal = process.env.TERMINAL ?? process.env.TERM ?? \"xterm\";\n    return execa(terminal, [\"-e\", command, ...args], options);\n  } else if (platform === \"win32\") {\n    // Windows: try PowerShell by default, fallback to CMD if needed\n    // try {\n    //   console.log('verifying')\n    //   // Try a harmless PowerShell command. We ignore stdio.\n    //   await execa(\n    //     'powershell.exe',\n    //     ['-Command', 'Write-Output \"PowerShell available\"; exit'],\n    //     {\n    //       all: true\n    //     }\n    //   )\n    //   return execa(\n    //     'cmd.exe',\n    //     [keepOpen ? '/k' : '/c', 'start', 'powershell.exe', '-Command', command, ...args],\n    //     options\n    //   )\n    // } catch (error) {\n    // Oops! No PowerShell? Fallback to CMD.\n    return execa(\n      \"cmd.exe\",\n      [keepOpen ? \"/k\" : \"/c\", \"start\", \"cmd.exe\", \"/c\", command, ...args],\n      options,\n    );\n    // }\n  } else {\n    throw new Error(\"Unsupported platform: \" + platform);\n  }\n};\n","import { join, dirname, basename } from \"node:path\";\nimport { platform } from \"node:os\";\nimport { chmod, mkdir, writeFile, cp } from \"node:fs/promises\";\nimport {\n  createAction,\n  createActionRunner,\n  createPathParam,\n  createStringParam,\n  fileExists,\n  runWithLiveLogs,\n} from \"@pipelab/plugin-core\";\nimport { checkSteamAuth, openExternalTerminal } from \"./utils\";\nimport { ExternalCommandError } from \"@pipelab/plugin-core\";\n\n// https://github.com/ztgasdf/steampkg?tab=readme-ov-file#account-management\n\n// How to login\n// Do it at least once\n// sdk/tools/ContentBuilder/builder_linux/steamcmd.sh +login User +quit\n\nexport const ID = \"steam-upload\";\n\nexport const uploadToSteam = createAction({\n  id: ID,\n  name: \"Upload to Steam\",\n  description: \"Upload a folder to Steam\",\n  icon: \"\",\n  displayString: \"`Upload ${fmt.param(params['folder'], 'primary')} to steam`\",\n  meta: {},\n  params: {\n    sdk: createPathParam(\"\", {\n      required: true,\n      label: \"Steam Sdk path\",\n      control: {\n        type: \"path\",\n        options: {\n          properties: [\"openDirectory\"],\n        },\n      },\n    }),\n    username: createStringParam(\"\", {\n      required: true,\n      label: \"Steam username\",\n    }),\n    appId: createStringParam(\"\", {\n      required: true,\n      label: \"App Id\",\n    }),\n    depotId: createStringParam(\"\", {\n      required: true,\n      label: \"Depot Id\",\n    }),\n    description: createStringParam(\"\", {\n      required: true,\n      label: \"Description\",\n    }),\n    folder: createPathParam(\"\", {\n      required: true,\n      label: \"Folder to upload\",\n      control: {\n        type: \"path\",\n        options: {\n          properties: [\"openDirectory\"],\n        },\n      },\n    }),\n    // enableDRM: {\n    //   value: false,\n    //   label: 'Enable DRM',\n    //   control: {\n    //     type: 'boolean'\n    //   }\n    // },\n    // binaryToPatch: createPathParam('', {\n    //   label: 'Binary to patch',\n    //   control: {\n    //     type: 'path',\n    //     options: {\n    //       properties: ['openFile']\n    //     }\n    //   }\n    // })\n  },\n  outputs: {\n    \"script-path\": {\n      label: \"Script path\",\n      value: \"\",\n    },\n    \"output-folder\": {\n      label: \"Output folder\",\n      value: \"\",\n    },\n    status: {\n      label: \"Status\",\n      value: \"\",\n    },\n  },\n});\n\nexport const uploadToSteamRunner = createActionRunner<typeof uploadToSteam>(\n  async ({ log, inputs, cwd, abortSignal, setOutput }) => {\n    const folder = inputs.folder as string;\n    const appId = inputs.appId as string;\n    const sdk = inputs.sdk as string;\n    const depotId = inputs.depotId as string;\n    const username = inputs.username as string;\n    const description = inputs.description as string;\n\n    log(`uploading \"${folder}\" to steam`);\n\n    const errorMap = {\n      6: `No connection to content server. Your depot id (${depotId}) may be invalid`,\n    };\n\n    const isSDKExisting = await fileExists(sdk);\n    if (!isSDKExisting) {\n      throw new Error(`You must enter a valid path to the Steam SDK`);\n    }\n\n    let builderFolder = \"builder\";\n    if (platform() === \"linux\") {\n      builderFolder += \"_linux\";\n    } else if (platform() === \"darwin\") {\n      builderFolder += \"_osx\";\n    }\n\n    const cmd = \"steamcmd\";\n    const extensions = platform() === \"win32\" ? [\".exe\", \".cmd\", \".bat\"] : [\".sh\"];\n\n    let cmdFinal = \"\";\n    let steamcmdPath = \"\";\n\n    for (const ext of extensions) {\n      const p = join(sdk as string, \"tools\", \"ContentBuilder\", builderFolder, cmd + ext);\n      if (await fileExists(p)) {\n        steamcmdPath = p;\n        cmdFinal = cmd + ext;\n        break;\n      }\n    }\n\n    // Fallback if none found (to maintain previous behavior of joining default)\n    if (!steamcmdPath) {\n      if (platform() === \"linux\" || platform() === \"darwin\") {\n        cmdFinal = \"steamcmd.sh\";\n      } else if (platform() === \"win32\") {\n        cmdFinal = \"steamcmd.exe\";\n      }\n      steamcmdPath = join(sdk as string, \"tools\", \"ContentBuilder\", builderFolder, cmdFinal);\n    }\n\n    console.log(\"steamcmdPath\", steamcmdPath);\n\n    if (platform() === \"linux\" || platform() === \"darwin\") {\n      if (platform() === \"linux\") {\n        log('Adding \"execute\" permissions to linux binary');\n        const steamcmdBinaryPath = join(\n          sdk,\n          \"tools\",\n          \"ContentBuilder\",\n          builderFolder,\n          \"linux32\",\n          cmd,\n        );\n        await chmod(steamcmdBinaryPath, 0o755);\n        const steamcmdBinaryErrorReporterPath = join(\n          sdk,\n          \"tools\",\n          \"ContentBuilder\",\n          builderFolder,\n          \"linux32\",\n          \"steamerrorreporter\",\n        );\n        await chmod(steamcmdBinaryErrorReporterPath, 0o755);\n      }\n\n      if (platform() === \"darwin\") {\n        const steamcmdBinaryPath = join(sdk, \"tools\", \"ContentBuilder\", builderFolder, cmd);\n        log('Adding \"execute\" permissions to darwin binary');\n        await chmod(steamcmdBinaryPath, 0o755);\n      }\n\n      log('Adding \"execute\" permissions to binary');\n      await chmod(steamcmdPath, 0o755);\n    }\n\n    const buildOutput = join(cwd, \"steam\", \"output\");\n    const scriptPath = join(cwd, \"steam\", \"script.vdf\");\n\n    setOutput(\"script-path\", scriptPath);\n    setOutput(\"output-folder\", buildOutput);\n\n    await mkdir(buildOutput, {\n      recursive: true,\n    });\n\n    await mkdir(dirname(scriptPath), {\n      recursive: true,\n    });\n\n    const script = `\"AppBuild\"\n{\n\t\"AppID\" \"${appId}\" // your AppID\n\t\"Desc\" \"${description}\" // internal description for this build\n\n\t\"ContentRoot\" \"${folder}\" // root content folder, relative to location of this file\n\t\"BuildOutput\" \"${buildOutput}\" // build output folder for build logs and build cache files\n\n\t\"Depots\"\n\t{\n\t\t\"${depotId}\" // your DepotID\n\t\t{\n\t\t\t\"FileMapping\"\n\t\t\t{\n\t\t\t\t\"LocalPath\" \"*\" // all files from contentroot folder\n\t\t\t\t\"DepotPath\" \".\" // mapped into the root of the depot\n\t\t\t\t\"recursive\" \"1\" // include all subfolders\n\t\t\t}\n\t\t}\n\t}\n}`;\n\n    console.log(\"script\", script);\n    const isAuthenticated = await checkSteamAuth({\n      context: {\n        log,\n        abortSignal,\n      },\n      scriptPath,\n      steamcmdPath,\n      username,\n    });\n\n    log(\"isAuthenticated\", JSON.stringify(isAuthenticated));\n\n    if (isAuthenticated.success === false) {\n      log(\"Opening terminal with interactive login\");\n      await openExternalTerminal(steamcmdPath, [\"+login\", username, \"+quit\"], {\n        cancelSignal: abortSignal,\n      });\n      const isAuthenticatedNow = await checkSteamAuth({\n        context: {\n          log,\n          abortSignal,\n        },\n        scriptPath,\n        steamcmdPath,\n        username,\n      });\n      if (isAuthenticatedNow.success === false) {\n        throw new Error(\"Not authenticated\");\n      }\n    }\n\n    log(\"Writing script\");\n    await writeFile(scriptPath, script, {\n      encoding: \"utf8\",\n      signal: abortSignal,\n    });\n\n    log(\"Executing steamcmd\");\n\n    // Should be authed here\n    try {\n      await runWithLiveLogs(\n        steamcmdPath,\n        [\"+login\", username, \"+run_app_build\", scriptPath, \"+quit\"],\n        {\n          shell: platform() === \"win32\",\n        },\n        log,\n        {\n          onStdout: (data) => {\n            log(\"[steamcmd]\", data);\n          },\n          onStderr: (data) => {\n            log(\"[steamcmd]\", data);\n          },\n        },\n        abortSignal,\n      );\n    } catch (e) {\n      if (e instanceof ExternalCommandError) {\n        const code = e.code as keyof typeof errorMap;\n        const message =\n          code in errorMap ? errorMap[code] : \"SteamCmd error:\" + e.code + \" \" + e.message;\n        throw new Error(message);\n      } else if (e instanceof Error) {\n        console.error(e);\n        throw new Error(\"Error:\" + e.message);\n      } else {\n        throw new Error(\"unknwon error\");\n      }\n    }\n\n    setOutput(\"status\", \"success\");\n    log(\"Done uploading\");\n  },\n);\n","import { uploadToSteam, uploadToSteamRunner } from \"./upload-to-steam\";\nimport { createNodeDefinition } from \"@pipelab/plugin-core\";\nconst icon = new URL(\"./steam.webp\", import.meta.url).href;\n\nexport default createNodeDefinition({\n  description: \"Steam\",\n  id: \"steam\",\n  name: \"Steam\",\n  icon: {\n    type: \"image\",\n    image: icon,\n  },\n  nodes: [\n    {\n      node: uploadToSteam,\n      runner: uploadToSteamRunner,\n    },\n  ],\n});\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@pipelab/plugin-steam",
+  "version": "1.0.0-beta.0",
+  "license": "FSL-1.1-MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CynToolkit/pipelab.git",
+    "directory": "plugins/plugin-steam"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@types/node": "^24.12.2",
+    "execa": "9.4.1",
+    "@pipelab/plugin-core": "1.0.0-beta.0"
+  },
+  "devDependencies": {
+    "tsdown": "0.21.2",
+    "typescript": "5.9.3",
+    "vitest": "3.1.4",
+    "@pipelab/test-utils": "1.0.0-beta.0",
+    "@pipelab/tsconfig": "1.0.0-beta.0"
+  },
+  "test": {
+    "env": {
+      "NODE_ENV": "development"
+    }
+  },
+  "scripts": {
+    "format": "oxfmt .",
+    "lint": "oxlint .",
+    "build": "tsdown",
+    "test": "vitest run -c tests/e2e/vitest.config.mts"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    }
+  }
+}

package/src/declarations.d.ts

@@ -0,0 +1 @@
+declare module "*.webp";

package/src/index.ts

@@ -0,0 +1,19 @@
+import { uploadToSteam, uploadToSteamRunner } from "./upload-to-steam";
+import { createNodeDefinition } from "@pipelab/plugin-core";
+const icon = new URL("./steam.webp", import.meta.url).href;
+
+export default createNodeDefinition({
+  description: "Steam",
+  id: "steam",
+  name: "Steam",
+  icon: {
+    type: "image",
+    image: icon,
+  },
+  nodes: [
+    {
+      node: uploadToSteam,
+      runner: uploadToSteamRunner,
+    },
+  ],
+});

package/src/upload-to-steam.ts

@@ -0,0 +1,299 @@
+import { join, dirname, basename } from "node:path";
+import { platform } from "node:os";
+import { chmod, mkdir, writeFile, cp } from "node:fs/promises";
+import {
+  createAction,
+  createActionRunner,
+  createPathParam,
+  createStringParam,
+  fileExists,
+  runWithLiveLogs,
+} from "@pipelab/plugin-core";
+import { checkSteamAuth, openExternalTerminal } from "./utils";
+import { ExternalCommandError } from "@pipelab/plugin-core";
+
+// https://github.com/ztgasdf/steampkg?tab=readme-ov-file#account-management
+
+// How to login
+// Do it at least once
+// sdk/tools/ContentBuilder/builder_linux/steamcmd.sh +login User +quit
+
+export const ID = "steam-upload";
+
+export const uploadToSteam = createAction({
+  id: ID,
+  name: "Upload to Steam",
+  description: "Upload a folder to Steam",
+  icon: "",
+  displayString: "`Upload ${fmt.param(params['folder'], 'primary')} to steam`",
+  meta: {},
+  params: {
+    sdk: createPathParam("", {
+      required: true,
+      label: "Steam Sdk path",
+      control: {
+        type: "path",
+        options: {
+          properties: ["openDirectory"],
+        },
+      },
+    }),
+    username: createStringParam("", {
+      required: true,
+      label: "Steam username",
+    }),
+    appId: createStringParam("", {
+      required: true,
+      label: "App Id",
+    }),
+    depotId: createStringParam("", {
+      required: true,
+      label: "Depot Id",
+    }),
+    description: createStringParam("", {
+      required: true,
+      label: "Description",
+    }),
+    folder: createPathParam("", {
+      required: true,
+      label: "Folder to upload",
+      control: {
+        type: "path",
+        options: {
+          properties: ["openDirectory"],
+        },
+      },
+    }),
+    // enableDRM: {
+    //   value: false,
+    //   label: 'Enable DRM',
+    //   control: {
+    //     type: 'boolean'
+    //   }
+    // },
+    // binaryToPatch: createPathParam('', {
+    //   label: 'Binary to patch',
+    //   control: {
+    //     type: 'path',
+    //     options: {
+    //       properties: ['openFile']
+    //     }
+    //   }
+    // })
+  },
+  outputs: {
+    "script-path": {
+      label: "Script path",
+      value: "",
+    },
+    "output-folder": {
+      label: "Output folder",
+      value: "",
+    },
+    status: {
+      label: "Status",
+      value: "",
+    },
+  },
+});
+
+export const uploadToSteamRunner = createActionRunner<typeof uploadToSteam>(
+  async ({ log, inputs, cwd, abortSignal, setOutput }) => {
+    const folder = inputs.folder as string;
+    const appId = inputs.appId as string;
+    const sdk = inputs.sdk as string;
+    const depotId = inputs.depotId as string;
+    const username = inputs.username as string;
+    const description = inputs.description as string;
+
+    log(`uploading "${folder}" to steam`);
+
+    const errorMap = {
+      6: `No connection to content server. Your depot id (${depotId}) may be invalid`,
+    };
+
+    const isSDKExisting = await fileExists(sdk);
+    if (!isSDKExisting) {
+      throw new Error(`You must enter a valid path to the Steam SDK`);
+    }
+
+    let builderFolder = "builder";
+    if (platform() === "linux") {
+      builderFolder += "_linux";
+    } else if (platform() === "darwin") {
+      builderFolder += "_osx";
+    }
+
+    const cmd = "steamcmd";
+    const extensions = platform() === "win32" ? [".exe", ".cmd", ".bat"] : [".sh"];
+
+    let cmdFinal = "";
+    let steamcmdPath = "";
+
+    for (const ext of extensions) {
+      const p = join(sdk as string, "tools", "ContentBuilder", builderFolder, cmd + ext);
+      if (await fileExists(p)) {
+        steamcmdPath = p;
+        cmdFinal = cmd + ext;
+        break;
+      }
+    }
+
+    // Fallback if none found (to maintain previous behavior of joining default)
+    if (!steamcmdPath) {
+      if (platform() === "linux" || platform() === "darwin") {
+        cmdFinal = "steamcmd.sh";
+      } else if (platform() === "win32") {
+        cmdFinal = "steamcmd.exe";
+      }
+      steamcmdPath = join(sdk as string, "tools", "ContentBuilder", builderFolder, cmdFinal);
+    }
+
+    console.log("steamcmdPath", steamcmdPath);
+
+    if (platform() === "linux" || platform() === "darwin") {
+      if (platform() === "linux") {
+        log('Adding "execute" permissions to linux binary');
+        const steamcmdBinaryPath = join(
+          sdk,
+          "tools",
+          "ContentBuilder",
+          builderFolder,
+          "linux32",
+          cmd,
+        );
+        await chmod(steamcmdBinaryPath, 0o755);
+        const steamcmdBinaryErrorReporterPath = join(
+          sdk,
+          "tools",
+          "ContentBuilder",
+          builderFolder,
+          "linux32",
+          "steamerrorreporter",
+        );
+        await chmod(steamcmdBinaryErrorReporterPath, 0o755);
+      }
+
+      if (platform() === "darwin") {
+        const steamcmdBinaryPath = join(sdk, "tools", "ContentBuilder", builderFolder, cmd);
+        log('Adding "execute" permissions to darwin binary');
+        await chmod(steamcmdBinaryPath, 0o755);
+      }
+
+      log('Adding "execute" permissions to binary');
+      await chmod(steamcmdPath, 0o755);
+    }
+
+    const buildOutput = join(cwd, "steam", "output");
+    const scriptPath = join(cwd, "steam", "script.vdf");
+
+    setOutput("script-path", scriptPath);
+    setOutput("output-folder", buildOutput);
+
+    await mkdir(buildOutput, {
+      recursive: true,
+    });
+
+    await mkdir(dirname(scriptPath), {
+      recursive: true,
+    });
+
+    const script = `"AppBuild"
+{
+	"AppID" "${appId}" // your AppID
+	"Desc" "${description}" // internal description for this build
+
+	"ContentRoot" "${folder}" // root content folder, relative to location of this file
+	"BuildOutput" "${buildOutput}" // build output folder for build logs and build cache files
+
+	"Depots"
+	{
+		"${depotId}" // your DepotID
+		{
+			"FileMapping"
+			{
+				"LocalPath" "*" // all files from contentroot folder
+				"DepotPath" "." // mapped into the root of the depot
+				"recursive" "1" // include all subfolders
+			}
+		}
+	}
+}`;
+
+    console.log("script", script);
+    const isAuthenticated = await checkSteamAuth({
+      context: {
+        log,
+        abortSignal,
+      },
+      scriptPath,
+      steamcmdPath,
+      username,
+    });
+
+    log("isAuthenticated", JSON.stringify(isAuthenticated));
+
+    if (isAuthenticated.success === false) {
+      log("Opening terminal with interactive login");
+      await openExternalTerminal(steamcmdPath, ["+login", username, "+quit"], {
+        cancelSignal: abortSignal,
+      });
+      const isAuthenticatedNow = await checkSteamAuth({
+        context: {
+          log,
+          abortSignal,
+        },
+        scriptPath,
+        steamcmdPath,
+        username,
+      });
+      if (isAuthenticatedNow.success === false) {
+        throw new Error("Not authenticated");
+      }
+    }
+
+    log("Writing script");
+    await writeFile(scriptPath, script, {
+      encoding: "utf8",
+      signal: abortSignal,
+    });
+
+    log("Executing steamcmd");
+
+    // Should be authed here
+    try {
+      await runWithLiveLogs(
+        steamcmdPath,
+        ["+login", username, "+run_app_build", scriptPath, "+quit"],
+        {
+          shell: platform() === "win32",
+        },
+        log,
+        {
+          onStdout: (data) => {
+            log("[steamcmd]", data);
+          },
+          onStderr: (data) => {
+            log("[steamcmd]", data);
+          },
+        },
+        abortSignal,
+      );
+    } catch (e) {
+      if (e instanceof ExternalCommandError) {
+        const code = e.code as keyof typeof errorMap;
+        const message =
+          code in errorMap ? errorMap[code] : "SteamCmd error:" + e.code + " " + e.message;
+        throw new Error(message);
+      } else if (e instanceof Error) {
+        console.error(e);
+        throw new Error("Error:" + e.message);
+      } else {
+        throw new Error("unknwon error");
+      }
+    }
+
+    setOutput("status", "success");
+    log("Done uploading");
+  },
+);

package/src/utils.ts

@@ -0,0 +1,125 @@
+import { runWithLiveLogs } from "@pipelab/plugin-core";
+import { execa, Options as ExecaOptions } from "execa";
+import os from "node:os";
+
+export type Options = {
+  steamcmdPath: string;
+  username: string;
+  scriptPath: string;
+  context: {
+    log: typeof console.log;
+    abortSignal: AbortSignal;
+  };
+};
+
+export const checkSteamAuth = async (options: Options) => {
+  let error: "LOGGED_OUT" | "UNKNOWN" | undefined = undefined;
+
+  try {
+    await runWithLiveLogs(
+      options.steamcmdPath,
+      ["+login", options.username, "+quit"],
+      {
+        shell: process.platform === "win32",
+      },
+      options.context.log,
+      {
+        onStdout: (data, subprocess) => {
+          options.context.log("[Steam Cmd]", data);
+          // TODO: handle password input dynamically
+          if (data.includes("Cached credentials not found")) {
+            error = "LOGGED_OUT";
+
+            subprocess.kill();
+          }
+        },
+      },
+      options.context.abortSignal,
+    );
+  } catch (e) {
+    console.error("e", e);
+    if (!error) {
+      error = "UNKNOWN";
+    }
+  }
+
+  if (error) {
+    return {
+      success: false,
+      error,
+    };
+  }
+
+  return {
+    success: true,
+  };
+};
+
+export const openExternalTerminal = async (
+  command: string,
+  args: string[] = [],
+  options: ExecaOptions = {},
+  keepOpen = false,
+) => {
+  const platform = process.platform;
+
+  if (platform === "darwin") {
+    // macOS: open in Terminal.app
+    const shellCommand = `${command} ${args.join(" ")}; echo "You can now close this window"`;
+    // Escape for AppleScript string literal
+    const escapedShellCommand = shellCommand
+      .replace(/\\/g, "\\\\") // Must escape backslashes first
+      .replace(/"/g, '\\"'); // Then escape double quotes
+
+    let osaScript: string;
+    if (keepOpen) {
+      // If keepOpen is true, just run the command and leave the terminal open.
+      // Added activate to bring Terminal to front.
+      osaScript = `tell application "Terminal"\nactivate\ndo script "${escapedShellCommand}"\nend tell`;
+    } else {
+      // If keepOpen is false (default), run the command, wait for it to finish, then close the tab.
+      osaScript = `tell application "Terminal"
+    activate
+    set targetTab to do script "${escapedShellCommand}"
+    -- Wait for the command to complete by checking the 'busy' status of the tab
+    delay 0.5 -- Initial delay to allow the process to start and tab to become busy
+    repeat while busy of targetTab
+        delay 0.5 -- Check every 0.5 seconds
+    end repeat
+end tell`;
+    }
+
+    return execa("osascript", ["-e", osaScript], options);
+  } else if (platform === "linux") {
+    // Linux: use $TERMINAL, $TERM, or fallback to xterm
+    const terminal = process.env.TERMINAL ?? process.env.TERM ?? "xterm";
+    return execa(terminal, ["-e", command, ...args], options);
+  } else if (platform === "win32") {
+    // Windows: try PowerShell by default, fallback to CMD if needed
+    // try {
+    //   console.log('verifying')
+    //   // Try a harmless PowerShell command. We ignore stdio.
+    //   await execa(
+    //     'powershell.exe',
+    //     ['-Command', 'Write-Output "PowerShell available"; exit'],
+    //     {
+    //       all: true
+    //     }
+    //   )
+    //   return execa(
+    //     'cmd.exe',
+    //     [keepOpen ? '/k' : '/c', 'start', 'powershell.exe', '-Command', command, ...args],
+    //     options
+    //   )
+    // } catch (error) {
+    // Oops! No PowerShell? Fallback to CMD.
+    return execa(
+      "cmd.exe",
+      [keepOpen ? "/k" : "/c", "start", "cmd.exe", "/c", command, ...args],
+      options,
+    );
+    // }
+  } else {
+    throw new Error("Unsupported platform: " + platform);
+  }
+};

package/tests/e2e/steam.spec.ts

@@ -0,0 +1,103 @@
+import { expect, test, describe, afterEach } from "vitest";
+import { mkdir, writeFile, access } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createSandbox, runAction, isWindows, isLinux, isMac } from "@pipelab/test-utils";
+import { uploadToSteamRunner } from "../../src/upload-to-steam";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+describe("End-to-End: Steam Integration", () => {
+  let sandbox: Awaited<ReturnType<typeof createSandbox>>;
+
+  afterEach(async () => {
+    if (sandbox) {
+      await sandbox.remove();
+    }
+  });
+
+  test(
+    "should mock a steam upload action using a single file",
+    async () => {
+      sandbox = await createSandbox("steam-e2e");
+      // 1. Setup mock Steam SDK
+      const mockSdkPath = join(sandbox.path, "mock-steam-sdk");
+      let builderFolder = "builder";
+      if (process.platform === "linux") {
+        builderFolder += "_linux";
+      } else if (process.platform === "darwin") {
+        builderFolder += "_osx";
+      }
+
+      const relativeSteamCmd = join(
+        "mock-steam-sdk",
+        "tools",
+        "ContentBuilder",
+        builderFolder,
+        "steamcmd",
+      );
+
+      // Create the mock steamcmd script that simulates a successful login and build
+      const mockScript = isWindows
+        ? `@echo off\necho Authenticated\nexit /b 0`
+        : `#!/bin/bash\necho "Authenticated"\nexit 0`;
+
+      await sandbox.mockBinary(relativeSteamCmd, mockScript);
+
+      if (isLinux) {
+        const linux32Dir = join(
+          "mock-steam-sdk",
+          "tools",
+          "ContentBuilder",
+          builderFolder,
+          "linux32",
+        );
+        await sandbox.mockBinary(join(linux32Dir, "steamcmd"), undefined, { extension: false });
+        await sandbox.mockBinary(join(linux32Dir, "steamerrorreporter"), undefined, {
+          extension: false,
+        });
+      }
+
+      if (isMac) {
+        await sandbox.mockBinary(
+          join("mock-steam-sdk", "tools", "ContentBuilder", builderFolder, "steamcmd"),
+          undefined,
+          { extension: false },
+        );
+      }
+
+      // 2. Setup a dummy single file to upload
+      const uploadFolder = join(sandbox.path, "to-upload");
+      await mkdir(uploadFolder, { recursive: true });
+      await writeFile(join(uploadFolder, "test-file.txt"), "This is a test file for steam upload.");
+
+      // 3. Run the action directly
+      const inputs = {
+        sdk: mockSdkPath,
+        username: "testuser",
+        appId: "123456",
+        depotId: "654321",
+        description: "Test Build",
+        folder: uploadFolder,
+      };
+
+      const result = await runAction(uploadToSteamRunner, {
+        inputs,
+        sandboxPath: sandbox.path,
+      });
+
+      // 4. Verification
+      const outputs = result.outputs;
+      expect(outputs).toBeDefined();
+      expect(outputs["script-path"]).toBeDefined();
+      expect(outputs["output-folder"]).toBeDefined();
+      expect(outputs["status"]).toBe("success");
+
+      // Verify files exist
+      await expect(access(outputs["script-path"] as string)).resolves.not.toThrow();
+      await expect(access(outputs["output-folder"] as string)).resolves.not.toThrow();
+    },
+    5 * 60 * 1000,
+  ); // 5 minutes timeout for real build
+});

package/tests/e2e/vitest.config.mts

@@ -0,0 +1,20 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    fileParallelism: false,
+    testTimeout: 60000,
+    hookTimeout: 60000,
+    maxWorkers: 1,
+    minWorkers: 1,
+    poolOptions: {
+      forks: {
+        singleFork: true,
+      },
+    },
+    include: ["**/*.spec.ts"],
+    root: "tests/e2e",
+    environment: "node",
+    env: { NODE_ENV: "development", PIPELAB_DISABLE_HISTORY: "true" },
+  },
+});

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@pipelab/tsconfig/vue.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}