@faable/faable 1.17.0 → 1.18.0

package/dist/commands/deploy/buildpacks/node/analyze_package.js

@@ -1,35 +0,0 @@
-import path__default from 'path';
-import { log } from '../../../../log.js';
-import { read_json_file } from '../shared/read_text_file.js';
-import { detect_framework } from './frameworks.js';
-
-const analyze_package = async (params) => {
-    const workdir = params.workdir;
-    const package_file = path__default.join(path__default.resolve(workdir), "package.json");
-    log.info(`Loading config from package.json`);
-    const pkg = read_json_file(package_file);
-    // Check if build is required to run
-    const build_script = process.env.FAABLE_NPM_BUILD_SCRIPT
-        ? process.env.FAABLE_NPM_BUILD_SCRIPT
-        : pkg?.scripts?.["build"]
-            ? "build"
-            : null;
-    if (!build_script) {
-        log.info(`No build script on package.json`);
-    }
-    const has_start = Boolean(pkg?.scripts?.["start"]);
-    const { type, start_command, inject_serve } = detect_framework({
-        pkg,
-        workdir,
-        has_start,
-    });
-    log.info(`⚡️ Detected deployment type=${type}`);
-    return {
-        build_script,
-        type,
-        start_command,
-        inject_serve,
-    };
-};
-
-export { analyze_package };

package/dist/commands/deploy/buildpacks/node/build_project.js

@@ -1,21 +0,0 @@
-import { log } from '../../../../log.js';
-import { cmd } from '../../../../lib/cmd.js';
-
-const build_project = async (args) => {
-    const { command, cwd } = args;
-    if (command) {
-        log.info(`⚙️ Building project [${command}]...`);
-        const timeout = 1000 * 60 * 30; // 30 minute timeout
-        await cmd(command, {
-            timeout,
-            cwd,
-            enableOutput: true,
-            ...(args?.env ? { env: args?.env } : {}),
-        });
-    }
-    else {
-        log.info(`⚡️ No build step`);
-    }
-};
-
-export { build_project };

package/dist/commands/deploy/buildpacks/node/ensure_dependencies.js

@@ -1,78 +0,0 @@
-import { existsSync } from 'fs';
-import { join, dirname } from 'path';
-import { log } from '../../../../log.js';
-import { cmd } from '../../../../lib/cmd.js';
-
-// Installing can be slow on cold CI runners (no npm cache).
-const INSTALL_TIMEOUT = 15 * 60 * 1000; // 15 minute timeout
-const defaultRun = (command, cwd) => cmd(command, { cwd, timeout: INSTALL_TIMEOUT, enableOutput: true });
-const defaultHasTool = async (name) => {
-    try {
-        await cmd(`command -v ${name}`);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-/**
- * Dependencies may live in the workdir or be hoisted to a parent directory
- * (monorepos). Walk upwards checking each level, stopping at the repo root
- * (first directory containing `.git`) or the filesystem root.
- */
-const has_node_modules = (workdir, exists) => {
-    let dir = workdir;
-    while (true) {
-        if (exists(join(dir, "node_modules")))
-            return true;
-        if (exists(join(dir, ".git")))
-            return false;
-        const parent = dirname(dir);
-        if (parent === dir)
-            return false;
-        dir = parent;
-    }
-};
-/**
- * Install dependencies when `node_modules` is missing, so `faable deploy`
- * works without a prior `npm ci` step — the generated GitHub Actions workflow
- * is language-agnostic and no longer installs anything itself. The build
- * (`npm run build`) and the image (`COPY . .` ships node_modules) both need
- * dependencies present on the host.
- *
- * The install command honors the project's lockfile; yarn/pnpm fall back to
- * `npm install` when the tool is missing, which may resolve slightly
- * different versions.
- */
-const ensure_dependencies = async (workdir, deps = {}) => {
-    const { run = defaultRun, hasTool = defaultHasTool, exists = existsSync } = deps;
-    if (has_node_modules(workdir, exists)) {
-        log.info(`📦 Dependencies already installed — skipping install (fresh dependencies)`);
-        return;
-    }
-    const has = (file) => exists(join(workdir, file));
-    let install = "npm install --no-audit --no-fund";
-    if (has("package-lock.json") || has("npm-shrinkwrap.json")) {
-        install = "npm ci";
-    }
-    else if (has("yarn.lock")) {
-        if (await hasTool("yarn")) {
-            install = "yarn install --frozen-lockfile";
-        }
-        else {
-            log.warn("yarn.lock found but yarn is not installed — using npm install");
-        }
-    }
-    else if (has("pnpm-lock.yaml")) {
-        if (await hasTool("pnpm")) {
-            install = "pnpm install --frozen-lockfile";
-        }
-        else {
-            log.warn("pnpm-lock.yaml found but pnpm is not installed — using npm install");
-        }
-    }
-    log.info(`📦 node_modules missing — installing dependencies [${install}]`);
-    await run(install, workdir);
-};
-
-export { ensure_dependencies };

package/dist/commands/deploy/buildpacks/node/frameworks.js

@@ -1,108 +0,0 @@
-import path__default from 'path';
-import * as R from 'ramda';
-import { log } from '../../../../log.js';
-import { read_json_file } from '../shared/read_text_file.js';
-
-const has_dep = (pkg, name) => Boolean(R.view(R.lensPath(["dependencies", name]), pkg) ||
-    R.view(R.lensPath(["devDependencies", name]), pkg));
-/**
- * Read Angular's build output path from angular.json. Defaults to `dist` when
- * it can't be resolved. Angular ≥17 (application builder) emits into
- * `<outputPath>/browser`, so we append it when the project uses that builder.
- */
-const resolve_angular_output = (workdir) => {
-    const fallback = "dist";
-    try {
-        const angular_json = read_json_file(path__default.join(workdir, "angular.json"));
-        const projects = angular_json?.projects ?? {};
-        const project_name = angular_json?.defaultProject ?? Object.keys(projects)[0];
-        const build = projects?.[project_name]?.architect?.build;
-        const output = build?.options?.outputPath;
-        if (!output)
-            return fallback;
-        const builder = build?.builder ?? "";
-        const is_application_builder = builder.includes("application") || builder.includes("browser-esbuild");
-        return is_application_builder ? path__default.join(output, "browser") : output;
-    }
-    catch {
-        return fallback;
-    }
-};
-/**
- * Framework registry, evaluated in order. Order matters: Astro/SvelteKit/CRA
- * pull Vite in transitively, so Vite must be the last static fallback.
- */
-const FRAMEWORKS = [
-    // Next.js: handled by its own runtime_strategy/PVC, never static-served here.
-    { type: "next", deps: ["next"] },
-    {
-        type: "astro",
-        deps: ["astro"],
-        outputDir: "dist",
-        serveCommand: (_dir) => `npx astro preview --host 0.0.0.0 --port $PORT`,
-    },
-    {
-        type: "gatsby",
-        deps: ["gatsby"],
-        outputDir: "public",
-        serveCommand: (_dir) => `npx gatsby serve --host 0.0.0.0 --port $PORT`,
-    },
-    {
-        type: "cra",
-        deps: ["react-scripts"],
-        outputDir: "build",
-        injectServe: true,
-        serveCommand: (dir) => `npx serve -s ${dir} -l $PORT`,
-    },
-    {
-        type: "vue",
-        deps: ["@vue/cli-service"],
-        outputDir: "dist",
-        injectServe: true,
-        serveCommand: (dir) => `npx serve -s ${dir} -l $PORT`,
-    },
-    {
-        type: "angular",
-        deps: ["@angular/cli", "@angular-devkit/build-angular"],
-        injectServe: true,
-        resolveOutput: resolve_angular_output,
-        serveCommand: (dir) => `npx serve -s ${dir} -l $PORT`,
-    },
-    {
-        type: "vite",
-        deps: ["vite"],
-        outputDir: "dist",
-        serveCommand: (_dir) => `npx vite preview --host 0.0.0.0 --port $PORT`,
-    },
-];
-/**
- * Detect the framework from package.json and compute how to serve it.
- *
- * When the project defines its own `start` script we never override it (the app
- * ships a real server — custom SSR, Nuxt, Remix, SvelteKit node-adapter, etc.),
- * so `start_command`/`inject_serve` stay neutral.
- */
-const detect_framework = (params) => {
-    const { pkg, workdir, has_start } = params;
-    const framework = FRAMEWORKS.find((fw) => fw.deps.some((dep) => has_dep(pkg, dep)));
-    if (!framework) {
-        return { type: "node", start_command: null, inject_serve: false };
-    }
-    // Static frameworks only override the start command when the project doesn't
-    // ship its own server.
-    if (framework.serveCommand && !has_start) {
-        const output_dir = framework.resolveOutput
-            ? framework.resolveOutput(workdir)
-            : framework.outputDir ?? "dist";
-        const start_command = framework.serveCommand(output_dir);
-        log.info(`No start script on package.json, serving ${framework.type} output (${output_dir}) with [${start_command}]`);
-        return {
-            type: framework.type,
-            start_command,
-            inject_serve: Boolean(framework.injectServe),
-        };
-    }
-    return { type: framework.type, start_command: null, inject_serve: false };
-};
-
-export { FRAMEWORKS, detect_framework, resolve_angular_output };

package/dist/commands/deploy/buildpacks/node/index.js

@@ -1,83 +0,0 @@
-import * as R from 'ramda';
-import { log } from '../../../../log.js';
-import { render_dockerfile, build_image } from '../shared/docker_image.js';
-import { has_any_of_files } from '../shared/has_any_of_files.js';
-import { analyze_package } from './analyze_package.js';
-import { build_project } from './build_project.js';
-import { ensure_dependencies } from './ensure_dependencies.js';
-import { inject_serve } from './inject_serve.js';
-import { resolve_node_version } from './node_version.js';
-import { wrap_next_config } from './wrap_next_config.js';
-
-const BANNER = `NODE_VERSION=$(node --version)
-NPM_VERSION=$(npm --version)
-YARN_VERSION=$(yarn --version 2>/dev/null || echo "n/a")
-
-echo "Faable Cloud · [node $NODE_VERSION] [npm $NPM_VERSION] [yarn $YARN_VERSION]"`;
-const node_buildpack = {
-    name: "node",
-    detect_files: ["package.json"],
-    async detect(ctx) {
-        if (!has_any_of_files(this.detect_files, ctx.workdir))
-            return null;
-        const version = await resolve_node_version(ctx.workdir);
-        const { build_script, type, start_command, inject_serve } = await analyze_package({ workdir: ctx.workdir });
-        // Precedence: explicit faable.json startCommand > framework-detected
-        // command (e.g. serving a static SPA) > default `npm run start`.
-        const start = ctx.config.startCommand ?? start_command ?? "npm run start";
-        return {
-            buildpack: "node",
-            runtime: { name: "node", version },
-            type,
-            start_command: start,
-            build_script,
-            inject_serve,
-            from: `node:${version}`,
-        };
-    },
-    async build(ctx, plan) {
-        const env = {
-            ...R.fromPairs(ctx.env_vars.map((e) => [e.name, e.value])),
-            // Platform-injected build-time identity, mirroring the runtime env the
-            // controller sets on the pod. FAABLE_DEPLOY_ID (build id ≡ runtime id)
-            // is the deterministic Next.js buildId source — user secrets can't
-            // override either. See arch/deploy/version-skew-coexistence.md.
-            FAABLE_APP_ID: ctx.app.id,
-            FAABLE_DEPLOY_ID: ctx.deployment.id,
-        };
-        log.info(`Building with env variables ${Object.keys(env).join(",")}`);
-        // The workflow no longer runs `npm ci` — install here when needed, before
-        // the build and before `COPY . .` packages node_modules into the image.
-        await ensure_dependencies(ctx.workdir);
-        // Host build step: npm script from the plan, else faable.json buildCommand.
-        const build_command = plan.build_script
-            ? `npm run ${plan.build_script}`
-            : ctx.config.buildCommand;
-        // Next: wrap next.config for the duration of the build so the buildId is
-        // the deployment id (transparent version-skew protection). Restored
-        // BEFORE the docker build — `COPY . .` must package the original config.
-        const wrapped = plan.type === "next" ? await wrap_next_config(ctx.workdir, env) : null;
-        try {
-            await build_project({ command: build_command, env, cwd: ctx.workdir });
-        }
-        finally {
-            await wrapped?.restore();
-        }
-        // Frameworks without a bundled static server (CRA/Vue/Angular) need
-        // `serve` installed into node_modules before packaging.
-        if (plan.inject_serve) {
-            await inject_serve(ctx.workdir);
-        }
-        log.info(`⚙️ Start command: ${plan.start_command}`);
-        log.info(`Using docker image ${plan.from}-slim`);
-        const dockerfile = render_dockerfile({
-            from: plan.from,
-            env: { NODE_ENV: "production" },
-            banner: BANNER,
-            start_command: plan.start_command,
-        });
-        await build_image({ app: ctx.app, workdir: ctx.workdir, dockerfile });
-    },
-};
-
-export { node_buildpack };

package/dist/commands/deploy/buildpacks/node/inject_serve.js

@@ -1,20 +0,0 @@
-import { log } from '../../../../log.js';
-import { cmd } from '../../../../lib/cmd.js';
-
-// Pinned for reproducible builds. `serve` is the standalone static server used
-// for frameworks without a bundled preview tool (CRA, Vue, Angular).
-const SERVE_VERSION = "14";
-/**
- * Install `serve` into the project's node_modules so it ships inside the image
- * via `COPY . .` (the Dockerfile does no `npm install`). This lets `npx serve`
- * resolve the local copy at container start — no runtime download needed.
- *
- * `--no-save` keeps the user's package.json/lockfile untouched.
- */
-const inject_serve = async (workdir) => {
-    log.info(`📥 Injecting static server (serve@${SERVE_VERSION}) into image`);
-    const timeout = 5 * 60 * 1000; // 5 minute timeout
-    await cmd(`npm install serve@${SERVE_VERSION} --no-save --no-audit --no-fund`, { cwd: workdir, timeout, enableOutput: true });
-};
-
-export { inject_serve };

package/dist/commands/deploy/buildpacks/node/node_version.js

@@ -1,41 +0,0 @@
-import path__default from 'path';
-import { cmd } from '../../../../lib/cmd.js';
-import { log } from '../../../../log.js';
-import { read_json_file } from '../shared/read_text_file.js';
-
-const getCurrentNodeVersion = async () => {
-    const out = await cmd(`node --version`);
-    const [_, version] = out.stdout.toString().trim().split("v");
-    return version;
-};
-/**
- * Resolve the Node version for the base image: `engines.node` from
- * package.json (resolved to a concrete release via `npm view`), else the
- * version running the deploy. Also validates the package has a `name`
- * (required since the beginning; kept for compatibility).
- */
-const resolve_node_version = async (workdir) => {
-    const packageJSONFile = path__default.join(workdir, "package.json");
-    const { name, engines } = read_json_file(packageJSONFile);
-    if (!name) {
-        throw new Error("Missing name in package.json");
-    }
-    let runtime_version = await getCurrentNodeVersion();
-    if (engines?.node) {
-        try {
-            const check_cmd = `npm view node@"${engines.node}" version | tail -n 1 | cut -d "'" -f2`;
-            const out = await cmd(check_cmd);
-            runtime_version = out.stdout.toString().trim();
-            log.info(`Using node@${runtime_version} from engines in package.json (${engines.node})`);
-        }
-        catch {
-            log.info(`Node version defined in engines in package.json is not valid (${engines.node}), using current version ${runtime_version}`);
-        }
-    }
-    else {
-        log.info(`Node version ${runtime_version}`);
-    }
-    return runtime_version;
-};
-
-export { resolve_node_version };

package/dist/commands/deploy/buildpacks/node/wrap_next_config.js

@@ -1,138 +0,0 @@
-import { existsSync, rmSync, renameSync } from 'fs';
-import { rename, writeFile, rm, readFile } from 'fs/promises';
-import path__default from 'path';
-import { log } from '../../../../log.js';
-
-/**
- * Transparent deterministic-buildId for Next.js apps
- * (arch/deploy/version-skew-coexistence.md, Fase 1).
- *
- * Next reads no env var for its buildId — the only deterministic source is
- * `generateBuildId` in the user's next.config. Rather than asking users to
- * edit their config, the buildpack wraps it for the duration of `next build`:
- * the original file is renamed aside and replaced by a generated wrapper that
- * resolves it (object | function | promise | async) and adds a
- * `generateBuildId` reading FAABLE_DEPLOY_ID — ONLY when the user doesn't
- * define their own.
- *
- * The wrapper is self-contained (no imports beyond the original config): the
- * user's node_modules has no faable packages.
- *
- * Restoration is guaranteed: `restore()` runs in the caller's finally (before
- * the docker build, so `COPY . .` packages the original config — `next start`
- * loads next.config at runtime too), and a signal handler covers Ctrl-C
- * mid-build. `next.config.ts` is skipped with a warning (it needs Next's own
- * TS loader; not wrappable from a JS wrapper).
- */
-const CONFIG_FILES = ["next.config.js", "next.config.cjs", "next.config.mjs"];
-const ORIGINAL_PREFIX = "next.config.faable-original";
-const wrapperBody = (originalFile, flavor) => {
-    const resolver = `
-const resolveConfig = async (original, phase, args) => {
-  let config = original && original.__esModule ? original.default : original;
-  if (typeof config === "function") config = config(phase, args);
-  config = await config;
-  config = config || {};
-  if (config.generateBuildId) return config; // user-defined wins, never override
-  return {
-    ...config,
-    // Deterministic buildId = platform deployment id (build id ≡ runtime id).
-    generateBuildId: () => process.env.FAABLE_DEPLOY_ID ?? null,
-  };
-};`;
-    if (flavor === "cjs") {
-        return `// Generated by faable deploy for this build only — auto-restored afterwards.
-// Adds a deterministic buildId (FAABLE_DEPLOY_ID) unless the config defines
-// its own generateBuildId. See faable.com docs on version skew.
-${originalFile ? `const original = require("./${originalFile}");` : `const original = {};`}
-${resolver}
-module.exports = (phase, args) => resolveConfig(original, phase, args);
-`;
-    }
-    return `// Generated by faable deploy for this build only — auto-restored afterwards.
-// Adds a deterministic buildId (FAABLE_DEPLOY_ID) unless the config defines
-// its own generateBuildId. See faable.com docs on version skew.
-${originalFile ? `import original from "./${originalFile}";` : `const original = {};`}
-${resolver}
-export default (phase, args) => resolveConfig(original, phase, args);
-`;
-};
-const packageIsESM = async (workdir) => {
-    try {
-        const pkg = JSON.parse(await readFile(path__default.join(workdir, "package.json"), "utf8"));
-        return pkg.type === "module";
-    }
-    catch {
-        return false;
-    }
-};
-/**
- * Wraps the project's next.config for the build. Returns null (no-op) when
- * there is nothing to do: FAABLE_DEPLOY_ID absent from `env`, a `.ts` config,
- * or the user already handles the buildId. Callers MUST `await
- * wrapped?.restore()` in a finally.
- */
-const wrap_next_config = async (workdir, env) => {
-    if (!env.FAABLE_DEPLOY_ID)
-        return null;
-    if (existsSync(path__default.join(workdir, "next.config.ts"))) {
-        log.warn(`next.config.ts detected — skipping the deterministic buildId wrap (define generateBuildId with FAABLE_DEPLOY_ID yourself to opt in).`);
-        return null;
-    }
-    const configFile = CONFIG_FILES.find((f) => existsSync(path__default.join(workdir, f)));
-    // Wrapper flavor/extension: mirror the original; with no config at all,
-    // .mjs is unambiguous regardless of package.json type.
-    let wrapperFile;
-    let originalFile = null;
-    let flavor;
-    if (!configFile) {
-        wrapperFile = "next.config.mjs";
-        flavor = "esm";
-    }
-    else {
-        const ext = path__default.extname(configFile); // .js | .cjs | .mjs
-        originalFile = `${ORIGINAL_PREFIX}${ext}`;
-        wrapperFile = configFile;
-        flavor =
-            ext === ".mjs" || (ext === ".js" && (await packageIsESM(workdir)))
-                ? "esm"
-                : "cjs";
-    }
-    const wrapperPath = path__default.join(workdir, wrapperFile);
-    const originalPath = originalFile ? path__default.join(workdir, originalFile) : null;
-    if (configFile && originalPath) {
-        await rename(path__default.join(workdir, configFile), originalPath);
-    }
-    await writeFile(wrapperPath, wrapperBody(originalFile, flavor), "utf8");
-    log.info(`🧬 Deterministic buildId: wrapped ${configFile ?? "(no next.config)"} → generateBuildId from FAABLE_DEPLOY_ID`);
-    // Ctrl-C / SIGTERM mid-build must not leave the user's workdir mutated.
-    const restoreSync = () => {
-        try {
-            rmSync(wrapperPath, { force: true });
-            if (configFile && originalPath) {
-                renameSync(originalPath, path__default.join(workdir, configFile));
-            }
-        }
-        catch {
-            // Best effort on the signal path
-        }
-    };
-    process.once("SIGINT", restoreSync);
-    process.once("SIGTERM", restoreSync);
-    let restored = false;
-    return {
-        restore: async () => {
-            if (restored)
-                return;
-            restored = true;
-            process.removeListener("SIGINT", restoreSync);
-            process.removeListener("SIGTERM", restoreSync);
-            await rm(wrapperPath, { force: true });
-            if (configFile && originalPath) {
-                await rename(originalPath, path__default.join(workdir, configFile));
-            }
-        },
-    };
-};
-
-export { wrap_next_config };

package/dist/commands/deploy/buildpacks/python/index.js

@@ -1,127 +0,0 @@
-import fs from 'fs-extra';
-import path__default from 'path';
-import { log } from '../../../../log.js';
-import { render_dockerfile, build_image } from '../shared/docker_image.js';
-import { has_any_of_files } from '../shared/has_any_of_files.js';
-import { read_text_file } from '../shared/read_text_file.js';
-import { cerebrium_provider } from './providers/cerebrium.js';
-import { pipfile_provider } from './providers/pipfile.js';
-import { pyproject_provider } from './providers/pyproject.js';
-import { requirements_provider } from './providers/requirements.js';
-import { resolve_python_version } from './python_version.js';
-import { resolve_start, with_server_injection, read_dependencies_text } from './resolve_start.js';
-
-const BANNER = `PYTHON_VERSION=$(python --version 2>&1)
-PIP_VERSION=$(pip --version 2>&1)
-
-echo "Faable Cloud · [$PYTHON_VERSION] [$PIP_VERSION]"`;
-const DOCS_URL = "https://faable.com/docs/deploy/build-requirements";
-// Evaluated in order: the first provider whose manifest exists supplies the
-// install command. Classic manifests come before platform-specific ones, so
-// a repo shipping both requirements.txt and cerebrium.toml builds from the
-// standard manifest.
-const PROVIDERS = [
-    requirements_provider,
-    pyproject_provider,
-    pipfile_provider,
-    cerebrium_provider,
-];
-const detect_with_provider = (ctx, provider) => {
-    const resolved = provider.resolve(ctx.workdir);
-    // Framework detection blob: all classic manifests plus whatever the winning
-    // provider contributes (e.g. cerebrium pip package names).
-    const deps = [read_dependencies_text(ctx.workdir), resolved.deps_text ?? ""]
-        .join("\n")
-        .toLowerCase();
-    let start_command;
-    let server;
-    try {
-        ({ start_command, server } = resolve_start(ctx.workdir, deps, ctx.config, resolved.start_hint));
-    }
-    catch (error) {
-        if (provider.name === "cerebrium") {
-            throw new Error("Detected a Cerebrium project (cerebrium.toml) but couldn't find a web " +
-                "entrypoint. Faable runs web services — expose a FastAPI/Flask app or " +
-                `set \`startCommand\` in faable.json. Docs: ${DOCS_URL}`, { cause: error });
-        }
-        throw error;
-    }
-    // faable.json buildCommand overrides the provider's install. The cacheable
-    // manifest layer only applies to the provider's own command — an arbitrary
-    // buildCommand may need the full source.
-    const base_install = ctx.config.buildCommand ?? resolved.install_command;
-    const install_command = with_server_injection(base_install, server, deps);
-    const install_files = ctx.config.buildCommand
-        ? undefined
-        : resolved.install_files;
-    const version = resolve_python_version(ctx.workdir, resolved.python_version);
-    log.info(`Using python@${version}`);
-    log.info(`📦 Install command: ${install_command}`);
-    log.info(`⚙️ Start command: ${start_command}`);
-    return {
-        buildpack: "python",
-        runtime: { name: "python", version },
-        type: "python",
-        start_command,
-        install_command,
-        install_files,
-        from: `python:${version}`,
-    };
-};
-const python_buildpack = {
-    name: "python",
-    detect_files: PROVIDERS.flatMap((p) => p.files),
-    fallback_files: ["main.py", "app.py", "wsgi.py"],
-    async detect(ctx) {
-        const provider = PROVIDERS.find((p) => has_any_of_files(p.files, ctx.workdir));
-        if (!provider)
-            return null;
-        return detect_with_provider(ctx, provider);
-    },
-    // Weak-signal pass: a Python entrypoint with no dependency manifest at all.
-    // Registered as fallback so it loses against any strong trigger (Dockerfile).
-    async detect_fallback(ctx) {
-        const entries = this.fallback_files.filter((f) => fs.existsSync(path__default.join(ctx.workdir, f)));
-        if (entries.length === 0)
-            return null;
-        log.warn(`⚠️ No dependency manifest (requirements.txt/pyproject.toml/Pipfile) found — ` +
-            `building from ${entries.join(", ")} without installing dependencies. ` +
-            `Your app will likely need a requirements.txt; see ${DOCS_URL}`);
-        // Framework detection blob = the entry files themselves: an
-        // `from fastapi import FastAPI` line carries the token detection needs.
-        const deps = entries
-            .map((f) => read_text_file(path__default.join(ctx.workdir, f)))
-            .join("\n")
-            .toLowerCase();
-        const { start_command, server } = resolve_start(ctx.workdir, deps, ctx.config);
-        const install_command = with_server_injection(ctx.config.buildCommand, server, deps);
-        const version = resolve_python_version(ctx.workdir);
-        log.info(`Using python@${version}`);
-        log.info(`📦 Install command: ${install_command}`);
-        log.info(`⚙️ Start command: ${start_command}`);
-        return {
-            buildpack: "python",
-            runtime: { name: "python", version },
-            type: "python",
-            start_command,
-            install_command,
-            from: `python:${version}`,
-        };
-    },
-    async build(ctx, plan) {
-        // Dependencies install inside the image (unlike node); nothing runs on
-        // the host here.
-        log.info(`Using docker image ${plan.from}-slim`);
-        const dockerfile = render_dockerfile({
-            from: plan.from,
-            env: { PYTHONUNBUFFERED: "1" },
-            banner: BANNER,
-            start_command: plan.start_command,
-            install_command: plan.install_command,
-            install_files: plan.install_files,
-        });
-        await build_image({ app: ctx.app, workdir: ctx.workdir, dockerfile });
-    },
-};
-
-export { python_buildpack };