swallowkit 2.0.0-alpha.1 → 2.0.0-alpha.10

package/src/utils/python-uv.ts

@@ -1,13 +1,13 @@
 import * as path from "path";
+import * as fs from "fs";
+import { execFile } from "child_process";
+import { promisify } from "util";
 
-export const SWALLOWKIT_PYTHON_VERSION = "3.11";
+const execFileAsync = promisify(execFile);
+export const DEFAULT_AZURE_PYTHON_VERSION = "3.14";
 
 export interface ProjectLocalUvPaths {
   stateDir: string;
-  cacheDir: string;
-  pythonInstallDir: string;
-  toolDir: string;
-  toolBinDir: string;
   localUvInstallDir: string;
   localUvExecutable: string;
 }
@@ -22,10 +22,6 @@ export function getProjectLocalUvPaths(projectRoot: string): ProjectLocalUvPaths
 
   return {
     stateDir,
-    cacheDir: path.join(stateDir, "cache"),
-    pythonInstallDir: path.join(stateDir, "python"),
-    toolDir: path.join(stateDir, "tools"),
-    toolBinDir: path.join(stateDir, "tools", "bin"),
     localUvInstallDir,
     localUvExecutable: process.platform === "win32"
       ? path.join(localUvInstallDir, "uv.exe")
@@ -33,40 +29,26 @@ export function getProjectLocalUvPaths(projectRoot: string): ProjectLocalUvPaths
   };
 }
 
-export function buildProjectLocalUvEnv(
+export function buildProjectLocalUvInstallerEnv(
   baseEnv: NodeJS.ProcessEnv,
   projectRoot: string
 ): NodeJS.ProcessEnv {
   const uvPaths = getProjectLocalUvPaths(projectRoot);
+
   const env: NodeJS.ProcessEnv = {
     ...baseEnv,
-    UV_CACHE_DIR: uvPaths.cacheDir,
-    UV_PYTHON_INSTALL_DIR: uvPaths.pythonInstallDir,
-    UV_TOOL_DIR: uvPaths.toolDir,
-    UV_TOOL_BIN_DIR: uvPaths.toolBinDir,
-    UV_PYTHON_PREFERENCE: "only-managed",
+    UV_UNMANAGED_INSTALL: uvPaths.localUvInstallDir,
+    UV_NO_MODIFY_PATH: "1",
   };
-
+  // Windows PowerShell must discover its own modules, not inherit PowerShell 7's.
   if (process.platform === "win32") {
-    env.UV_PYTHON_NO_REGISTRY = "true";
+    for (const key of Object.keys(env)) {
+      if (key.toLowerCase() === "psmodulepath") delete env[key];
+    }
   }
-
   return env;
 }
 
-export function buildProjectLocalUvInstallerEnv(
-  baseEnv: NodeJS.ProcessEnv,
-  projectRoot: string
-): NodeJS.ProcessEnv {
-  const uvPaths = getProjectLocalUvPaths(projectRoot);
-
-  return {
-    ...buildProjectLocalUvEnv(baseEnv, projectRoot),
-    UV_UNMANAGED_INSTALL: uvPaths.localUvInstallDir,
-    UV_NO_MODIFY_PATH: "1",
-  };
-}
-
 export function getProjectLocalUvInstallerCommand(): { command: string; args: string[] } {
   if (process.platform === "win32") {
     return {
@@ -87,10 +69,48 @@ export function getProjectLocalUvInstallerCommand(): { command: string; args: st
   };
 }
 
-export function buildUvVenvArgs(venvDir: string, pythonVersion = SWALLOWKIT_PYTHON_VERSION): string[] {
-  return ["venv", venvDir, "--python", pythonVersion];
+export function buildUvVenvArgs(venvDir: string): string[] {
+  return ["venv", venvDir];
+}
+
+export function getVirtualEnvPythonPath(venvDir: string): string {
+  return process.platform === "win32"
+    ? path.join(venvDir, "Scripts", "python.exe")
+    : path.join(venvDir, "bin", "python");
+}
+
+export async function ensureUvVirtualEnvironment(
+  uvCommand: string,
+  venvDir: string,
+  cwd: string,
+  env: NodeJS.ProcessEnv
+): Promise<string> {
+  const pythonExecutable = getVirtualEnvPythonPath(venvDir);
+  if (!fs.existsSync(venvDir)) {
+    const { stdout, stderr } = await execFileAsync(uvCommand, buildUvVenvArgs(venvDir), { cwd, env });
+    if (env.SWALLOWKIT_MACHINE_OUTPUT !== "1") {
+      if (stdout) process.stdout.write(stdout);
+      if (stderr) process.stderr.write(stderr);
+    }
+  }
+  try {
+    await execFileAsync(pythonExecutable, ["--version"], { cwd, env });
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Cannot execute Python at ${pythonExecutable}: ${reason}\n` +
+      "The virtual environment was preserved. Check the interpreter and OS application-control policy. " +
+      "To switch Python, explicitly recreate this environment with uv and a trusted interpreter; SwallowKit will not clear it automatically."
+    );
+  }
+  return pythonExecutable;
 }
 
 export function buildUvPipInstallArgs(pythonExecutable: string, requirementsPath: string): string[] {
   return ["pip", "install", "--python", pythonExecutable, "-r", requirementsPath];
 }
+
+export function buildPythonCodegenInstallEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv {
+  // Codegen reads JSON; PyYAML's optional accelerator must not require a C compiler.
+  return { ...env, PYYAML_FORCE_LIBYAML: env.PYYAML_FORCE_LIBYAML ?? "0" };
+}

package/src/utils/react-dev.ts

@@ -0,0 +1,31 @@
+export const REACT_DEV_WATCH_DIRECTORIES = [
+  "functions",
+  "bff",
+  ".uv",
+  ".swallowkit",
+  "shared/dist",
+];
+
+export function buildReactDevWatchIgnoredSource(rootExpression: string): string {
+  return `${JSON.stringify(REACT_DEV_WATCH_DIRECTORIES)}.map(directory => \`\${${rootExpression}.replace(/\\\\/g, '/').replace(/\\/$/, '')}/\${directory}/**\`)`;
+}
+
+export function buildReactDevConfigSource(): string {
+  return `import { defineConfig, loadConfigFromFile, mergeConfig } from 'vite';
+
+export default defineConfig(async env => {
+  const loaded = await loadConfigFromFile(env, undefined, process.cwd());
+  const config = loaded?.config ?? {};
+  if (config.server?.watch === null) return config;
+  return mergeConfig(config, {
+    plugins: [{
+      name: 'swallowkit-dev-watch-boundaries',
+      configResolved(resolved) {
+        resolved.configFileDependencies.push(...(loaded?.dependencies ?? []));
+      },
+    }],
+    server: { watch: { ignored: ${buildReactDevWatchIgnoredSource("process.cwd()")} } },
+  });
+});
+`;
+}

package/src/utils/semver.ts

@@ -0,0 +1,59 @@
+export interface ParsedSemver {
+  major: number;
+  minor: number;
+  patch: number;
+  prerelease: Array<string | number>;
+}
+
+const SEMVER_PATTERN =
+  /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+
+export function parseSemver(value: string | null | undefined): ParsedSemver | null {
+  const match = typeof value === "string" ? SEMVER_PATTERN.exec(value.trim()) : null;
+  if (!match) return null;
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    prerelease: match[4]
+      ? match[4].split(".").map((identifier) => (/^\d+$/.test(identifier) ? Number(identifier) : identifier))
+      : [],
+  };
+}
+
+export function isPrerelease(value: string): boolean {
+  return (parseSemver(value)?.prerelease.length ?? 0) > 0;
+}
+
+/**
+ * Compares versions by SemVer 2.0 precedence. Build metadata is ignored.
+ * Returns null when either value is not a valid version.
+ */
+export function compareSemver(left: string, right: string): number | null {
+  const a = parseSemver(left);
+  const b = parseSemver(right);
+  if (!a || !b) return null;
+
+  for (const key of ["major", "minor", "patch"] as const) {
+    if (a[key] !== b[key]) return a[key] < b[key] ? -1 : 1;
+  }
+
+  if (a.prerelease.length === 0 || b.prerelease.length === 0) {
+    if (a.prerelease.length === b.prerelease.length) return 0;
+    return a.prerelease.length === 0 ? 1 : -1;
+  }
+
+  const length = Math.max(a.prerelease.length, b.prerelease.length);
+  for (let index = 0; index < length; index++) {
+    const leftId = a.prerelease[index];
+    const rightId = b.prerelease[index];
+    if (leftId === undefined) return -1;
+    if (rightId === undefined) return 1;
+    if (leftId === rightId) continue;
+    if (typeof leftId === "number" && typeof rightId === "number") return leftId < rightId ? -1 : 1;
+    if (typeof leftId === "number") return -1;
+    if (typeof rightId === "number") return 1;
+    return leftId < rightId ? -1 : 1;
+  }
+  return 0;
+}