quik-cli 1.0.0

package/dist/utils/PackageInstaller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageInstaller.d.ts","sourceRoot":"","sources":["../../src/utils/PackageInstaller.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAuDf"}

package/dist/utils/PackageInstaller.js

@@ -0,0 +1,100 @@
+import { spawn } from "node:child_process";
+import { mkdtemp, writeFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { QuikError, ErrorCode } from "../core/QuikError.js";
+const GITHUB_REGISTRY = "https://npm.pkg.github.com";
+const PRIVATE_SCOPES = ["@quikcr"];
+/**
+ * Installs a private GitHub Package using npm.
+ *
+ * Features:
+ * - Supports multiple private scopes.
+ * - Does not expose the GitHub token in CLI arguments.
+ * - Does not modify the user's existing ~/.npmrc.
+ * - Works on Windows, macOS and Linux.
+ * - Temporary npm configuration is automatically removed.
+ *
+ * @param packageName Example: "@quikcr/quik-engine"
+ * @param version Example: "1.0.29"
+ * @param githubToken GitHub access token for GitHub Packages
+ * @param cwd Working directory where npm install runs
+ */
+export async function installGitHubPackage(packageName, version, githubToken, cwd) {
+    if (!packageName) {
+        throw new QuikError(ErrorCode.NET_002, "network", "Package name is required");
+    }
+    if (!version) {
+        throw new QuikError(ErrorCode.NET_002, "network", "Package version is required");
+    }
+    if (!githubToken) {
+        throw new QuikError(ErrorCode.NET_002, "network", "GitHub token is required");
+    }
+    const npmConfigDir = await mkdtemp(join(tmpdir(), "quik-npm-"));
+    const npmConfigPath = join(npmConfigDir, ".npmrc");
+    try {
+        const npmrc = [
+            ...PRIVATE_SCOPES.map((scope) => `${scope}:registry=${GITHUB_REGISTRY}`),
+            `//npm.pkg.github.com/:_authToken=${githubToken}`,
+            "always-auth=true",
+            "",
+        ].join("\n");
+        await writeFile(npmConfigPath, npmrc, {
+            encoding: "utf8",
+            mode: 0o600,
+        });
+        await runNpmInstall(packageName, version, cwd, npmConfigPath);
+    }
+    finally {
+        await rm(npmConfigDir, {
+            recursive: true,
+            force: true,
+        });
+    }
+}
+function runNpmInstall(packageName, version, cwd, npmConfigPath) {
+    return new Promise((resolve, reject) => {
+        const npmCommand = process.platform === "win32"
+            ? "npm.cmd"
+            : "npm";
+        const npm = spawn(npmCommand, ["install", `${packageName}@${version}`], {
+            cwd,
+            env: {
+                ...process.env,
+                NPM_CONFIG_USERCONFIG: npmConfigPath,
+            },
+            stdio: ["ignore", "pipe", "pipe"],
+            windowsHide: true,
+            shell: process.platform === "win32",
+        });
+        let stderr = "";
+        let stdout = "";
+        npm.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        npm.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        npm.on("error", (error) => {
+            reject(new QuikError(ErrorCode.NET_002, "network", `Failed to start npm: ${error.message}`));
+        });
+        npm.on("close", (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            const errorMessage = getNpmErrorMessage(stderr, stdout);
+            reject(new QuikError(ErrorCode.NET_002, "network", `Failed to install ${packageName}@${version}: ${errorMessage}`));
+        });
+    });
+}
+function getNpmErrorMessage(stderr, stdout) {
+    const output = `${stderr}\n${stdout}`.trim();
+    const lines = output
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    return (lines.at(-1) ??
+        "npm install failed");
+}
+//# sourceMappingURL=PackageInstaller.js.map

package/dist/utils/PackageInstaller.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "quik-cli",
+  "version": "1.0.0",
+  "description": "Fast, dynamic, plugin-based CLI framework",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "quik": "bin/quik.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-templates.js",
+    "dev": "tsx bin/quik.dev.ts",
+    "dev:bun": "bun bin/quik.dev.ts",
+    "start": "node bin/quik.js"
+  },
+  "keywords": [
+    "quik",
+    "cli",
+    "plugin",
+    "framework"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "cosmiconfig": "^9.0.0",
+    "enquirer": "^2.4.1",
+    "jiti": "^2.7.0",
+    "ora": "^8.1.0",
+    "picocolors": "^1.1.1",
+    "save-dev": "^0.0.1-security"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.4"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}