@trigger.dev/build 0.0.0-python-preview-20250226140121 → 0.0.0-rc-4-8-0-20261021151928

package/dist/esm/extensions/playwright.d.ts

@@ -0,0 +1,65 @@
+import type { BuildContext, BuildExtension } from "@trigger.dev/core/v3/build";
+import type { BuildManifest, BuildTarget } from "@trigger.dev/core/v3";
+type PlaywrightBrowser = "chromium" | "firefox" | "webkit";
+interface PlaywrightExtensionOptions {
+    /**
+     * Browsers to install. Select only needed browsers to optimize build time and size.
+     * @default ["chromium"]
+     */
+    browsers?: PlaywrightBrowser[];
+    /**
+     * Run the browsers in headless mode (Recommended)
+     * @default true
+     */
+    headless?: boolean;
+    /**
+     * Playwright version override. If not provided, we will try to detect the version automatically.
+     */
+    version?: string;
+}
+/**
+ * Installs Playwright browsers and dependencies for your Trigger.dev deployments.
+ *
+ * @param options - Configuration options for the Playwright extension.
+ * @param options.browsers Browsers to install. Accepts an array of strings. Default: `["chromium"]`
+ * @param options.headless Whether to run browsers in headless mode. Default: `true`
+ * @param options.version Playwright version to use for browser installation. When not set, will automatically detect the version (recommended). Default: `undefined`
+ *
+ */
+export declare function playwright(options?: PlaywrightExtensionOptions): PlaywrightExtension;
+/**
+ * Extended regex selecting a browser's block header in `playwright install --dry-run` output.
+ *
+ * Playwright < 1.58 prints `browser: <name> version <v>`; 1.58+ prints
+ * `<Product> <v> (playwright <name> v<build>)`. The trailing space / `v` keep
+ * `chromium` from matching the `chromium-headless-shell` block.
+ *
+ * @internal
+ */
+export declare function dryRunHeaderPattern(browser: string): string;
+/**
+ * Background:
+ *
+ * Running `npx playwright install --with-deps` normally will install the browsers and the dependencies.
+ * However, this is not possible in a build context, because we don't have sudo access.
+ *
+ * So we need to install the dependencies manually and then download and install the browsers.
+ * This has a few challenges:
+ * 1. We don't want to download all browsers, only the ones we need with it's dependencies
+ *    The less dependencies we have to install, the faster the build, and the smaller the image.
+ * 2. We need to know where to download the browsers from
+ *    while we can hardcode the download url it might change over time (as it has in the past)
+ *    so we need to download the browser info first and then parse the output to get the download url.
+ *
+ * Note: While this looks like we are downloading & installing a lot of stuff, it's actually not that bad
+ *       since running `npx playwright install --with-deps` will result in the same amount of downloads.
+ */
+declare class PlaywrightExtension implements BuildExtension {
+    readonly name = "PlaywrightExtension";
+    private moduleExternals;
+    private readonly options;
+    constructor({ browsers, headless, version, }?: PlaywrightExtensionOptions);
+    externalsForTarget(target: BuildTarget): string[];
+    onBuildComplete(context: BuildContext, manifest: BuildManifest): void;
+}
+export {};

package/dist/esm/extensions/playwright.js

@@ -0,0 +1,320 @@
+/**
+ * This list is from the official playwright registry.
+ *
+ * @see https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/registry/nativeDeps.ts
+ */
+const debian12Deps = {
+    tools: [
+        "xvfb",
+        "fonts-noto-color-emoji",
+        "fonts-unifont",
+        "libfontconfig1",
+        "libfreetype6",
+        "xfonts-scalable",
+        "fonts-liberation",
+        "fonts-ipafont-gothic",
+        "fonts-wqy-zenhei",
+        "fonts-tlwg-loma-otf",
+        "fonts-freefont-ttf",
+    ],
+    chromium: [
+        "libasound2",
+        "libatk-bridge2.0-0",
+        "libatk1.0-0",
+        "libatspi2.0-0",
+        "libcairo2",
+        "libcups2",
+        "libdbus-1-3",
+        "libdrm2",
+        "libgbm1",
+        "libglib2.0-0",
+        "libnspr4",
+        "libnss3",
+        "libpango-1.0-0",
+        "libx11-6",
+        "libxcb1",
+        "libxcomposite1",
+        "libxdamage1",
+        "libxext6",
+        "libxfixes3",
+        "libxkbcommon0",
+        "libxrandr2",
+    ],
+    firefox: [
+        "libasound2",
+        "libatk1.0-0",
+        "libcairo-gobject2",
+        "libcairo2",
+        "libdbus-1-3",
+        "libdbus-glib-1-2",
+        "libfontconfig1",
+        "libfreetype6",
+        "libgdk-pixbuf-2.0-0",
+        "libglib2.0-0",
+        "libgtk-3-0",
+        "libharfbuzz0b",
+        "libpango-1.0-0",
+        "libpangocairo-1.0-0",
+        "libx11-6",
+        "libx11-xcb1",
+        "libxcb-shm0",
+        "libxcb1",
+        "libxcomposite1",
+        "libxcursor1",
+        "libxdamage1",
+        "libxext6",
+        "libxfixes3",
+        "libxi6",
+        "libxrandr2",
+        "libxrender1",
+        "libxtst6",
+    ],
+    webkit: [
+        "libsoup-3.0-0",
+        "gstreamer1.0-libav",
+        "gstreamer1.0-plugins-bad",
+        "gstreamer1.0-plugins-base",
+        "gstreamer1.0-plugins-good",
+        "libatk-bridge2.0-0",
+        "libatk1.0-0",
+        "libcairo2",
+        "libdbus-1-3",
+        "libdrm2",
+        "libegl1",
+        "libenchant-2-2",
+        "libepoxy0",
+        "libevdev2",
+        "libfontconfig1",
+        "libfreetype6",
+        "libgbm1",
+        "libgdk-pixbuf-2.0-0",
+        "libgles2",
+        "libglib2.0-0",
+        "libglx0",
+        "libgstreamer-gl1.0-0",
+        "libgstreamer-plugins-base1.0-0",
+        "libgstreamer1.0-0",
+        "libgtk-4-1",
+        "libgudev-1.0-0",
+        "libharfbuzz-icu0",
+        "libharfbuzz0b",
+        "libhyphen0",
+        "libicu72",
+        "libjpeg62-turbo",
+        "liblcms2-2",
+        "libmanette-0.2-0",
+        "libnotify4",
+        "libopengl0",
+        "libopenjp2-7",
+        "libopus0",
+        "libpango-1.0-0",
+        "libpng16-16",
+        "libproxy1v5",
+        "libsecret-1-0",
+        "libwayland-client0",
+        "libwayland-egl1",
+        "libwayland-server0",
+        "libwebp7",
+        "libwebpdemux2",
+        "libwoff1",
+        "libx11-6",
+        "libxcomposite1",
+        "libxdamage1",
+        "libxkbcommon0",
+        "libxml2",
+        "libxslt1.1",
+        "libatomic1",
+        "libevent-2.1-7",
+        "libavif15",
+    ],
+    lib2package: {
+        "libavif.so.15": "libavif15",
+        "libsoup-3.0.so.0": "libsoup-3.0-0",
+        "libasound.so.2": "libasound2",
+        "libatk-1.0.so.0": "libatk1.0-0",
+        "libatk-bridge-2.0.so.0": "libatk-bridge2.0-0",
+        "libatspi.so.0": "libatspi2.0-0",
+        "libcairo.so.2": "libcairo2",
+        "libcups.so.2": "libcups2",
+        "libdbus-1.so.3": "libdbus-1-3",
+        "libdrm.so.2": "libdrm2",
+        "libgbm.so.1": "libgbm1",
+        "libgio-2.0.so.0": "libglib2.0-0",
+        "libglib-2.0.so.0": "libglib2.0-0",
+        "libgobject-2.0.so.0": "libglib2.0-0",
+        "libnspr4.so": "libnspr4",
+        "libnss3.so": "libnss3",
+        "libnssutil3.so": "libnss3",
+        "libpango-1.0.so.0": "libpango-1.0-0",
+        "libsmime3.so": "libnss3",
+        "libX11.so.6": "libx11-6",
+        "libxcb.so.1": "libxcb1",
+        "libXcomposite.so.1": "libxcomposite1",
+        "libXdamage.so.1": "libxdamage1",
+        "libXext.so.6": "libxext6",
+        "libXfixes.so.3": "libxfixes3",
+        "libxkbcommon.so.0": "libxkbcommon0",
+        "libXrandr.so.2": "libxrandr2",
+        "libgtk-4.so.1": "libgtk-4-1",
+    },
+};
+/**
+ * Installs Playwright browsers and dependencies for your Trigger.dev deployments.
+ *
+ * @param options - Configuration options for the Playwright extension.
+ * @param options.browsers Browsers to install. Accepts an array of strings. Default: `["chromium"]`
+ * @param options.headless Whether to run browsers in headless mode. Default: `true`
+ * @param options.version Playwright version to use for browser installation. When not set, will automatically detect the version (recommended). Default: `undefined`
+ *
+ */
+export function playwright(options = {}) {
+    return new PlaywrightExtension(options);
+}
+/**
+ * Extended regex selecting a browser's block header in `playwright install --dry-run` output.
+ *
+ * Playwright < 1.58 prints `browser: <name> version <v>`; 1.58+ prints
+ * `<Product> <v> (playwright <name> v<build>)`. The trailing space / `v` keep
+ * `chromium` from matching the `chromium-headless-shell` block.
+ *
+ * @internal
+ */
+export function dryRunHeaderPattern(browser) {
+    return `browser: ${browser} |\\(playwright ${browser} v`;
+}
+/**
+ * Background:
+ *
+ * Running `npx playwright install --with-deps` normally will install the browsers and the dependencies.
+ * However, this is not possible in a build context, because we don't have sudo access.
+ *
+ * So we need to install the dependencies manually and then download and install the browsers.
+ * This has a few challenges:
+ * 1. We don't want to download all browsers, only the ones we need with it's dependencies
+ *    The less dependencies we have to install, the faster the build, and the smaller the image.
+ * 2. We need to know where to download the browsers from
+ *    while we can hardcode the download url it might change over time (as it has in the past)
+ *    so we need to download the browser info first and then parse the output to get the download url.
+ *
+ * Note: While this looks like we are downloading & installing a lot of stuff, it's actually not that bad
+ *       since running `npx playwright install --with-deps` will result in the same amount of downloads.
+ */
+class PlaywrightExtension {
+    name = "PlaywrightExtension";
+    moduleExternals;
+    options;
+    constructor({ browsers = ["chromium"], headless = true, version, } = {}) {
+        if (browsers && browsers.length === 0) {
+            throw new Error("At least one browser must be specified");
+        }
+        this.options = { browsers, headless, version };
+        this.moduleExternals = ["playwright"];
+    }
+    externalsForTarget(target) {
+        if (target === "dev") {
+            return [];
+        }
+        return this.moduleExternals;
+    }
+    onBuildComplete(context, manifest) {
+        if (context.target === "dev")
+            return;
+        // Detect Playwright version from manifest.externals or use override
+        const playwrightExternal = manifest.externals?.find((external) => external.name === "playwright" || external.name === "@playwright/test");
+        const version = playwrightExternal?.version ?? this.options.version;
+        if (!version) {
+            throw new Error("PlaywrightExtension could not determine the version of playwright. Please provide a version in the PlaywrightExtension options.");
+        }
+        context.logger.debug(`Adding ${this.name} to the build with browsers: ${this.options.browsers.join(", ")}, version: ${version}`);
+        const instructions = [
+            // Base dependencies, we need these to download the browsers
+            `RUN apt-get update && apt-get install -y --no-install-recommends \
+        curl \
+        unzip \
+        jq \
+        grep \
+        sed \
+        npm \
+        && apt-get clean && rm -rf /var/lib/apt/lists/*`,
+            // Install Playwright globally with detected version
+            `RUN npm install -g playwright@${version}`,
+        ];
+        const deps = [...debian12Deps.tools, ...Object.values(debian12Deps.lib2package)];
+        if (this.options.browsers.includes("chromium"))
+            deps.push(...debian12Deps.chromium);
+        if (this.options.browsers.includes("firefox"))
+            deps.push(...debian12Deps.firefox);
+        if (this.options.browsers.includes("webkit"))
+            deps.push(...debian12Deps.webkit);
+        instructions.push(`RUN apt-get update && apt-get install -y --no-install-recommends ${deps.join(" ")} \
+        && apt-get clean && rm -rf /var/lib/apt/lists/*`);
+        // Setup directory for playwright browsers
+        instructions.push(`RUN mkdir -p /ms-playwright`);
+        /**
+         * `npx playwright install --dry-run` prints the download urls for the browsers.
+         * We save this output to a file and then parse it to get the download urls for the browsers.
+         */
+        instructions.push(`RUN npx playwright install --dry-run > /tmp/browser-info.txt`);
+        // Determine which browsers to actually install
+        const browsersToInstall = new Set();
+        this.options.browsers.forEach((browser) => {
+            if (browser === "chromium") {
+                if (this.options.headless) {
+                    // For headless mode, only install chromium-headless-shell
+                    browsersToInstall.add("chromium-headless-shell");
+                }
+                else {
+                    // For non-headless mode, install both chromium and chromium-headless-shell
+                    // This allows users to easily switch between headless and non-headless mode
+                    browsersToInstall.add("chromium");
+                    browsersToInstall.add("chromium-headless-shell");
+                }
+            }
+            else {
+                browsersToInstall.add(browser);
+            }
+        });
+        Array.from(browsersToInstall).forEach((browser) => {
+            instructions.push(
+            // Only the two lines after the header (install location, download url)
+            // are read, so the window stops there.
+            `RUN grep -A2 -m1 -E "${dryRunHeaderPattern(browser)}" /tmp/browser-info.txt > /tmp/${browser}-info.txt`, `RUN INSTALL_DIR=$(grep "Install location:" /tmp/${browser}-info.txt | cut -d':' -f2- | xargs) && \
+          DIR_NAME=$(basename "$INSTALL_DIR") && \
+          if [ -z "$DIR_NAME" ]; then echo "Failed to extract installation directory for ${browser}"; exit 1; fi && \
+          MS_DIR="/ms-playwright/$DIR_NAME" && \
+          mkdir -p "$MS_DIR"`, `RUN DOWNLOAD_URL=$(grep "Download url:" /tmp/${browser}-info.txt | cut -d':' -f2- | xargs | sed "s/mac-arm64/linux/g" | sed "s/mac-15-arm64/ubuntu-20.04/g") && \
+          if [ -z "$DOWNLOAD_URL" ]; then echo "Failed to extract download URL for ${browser}"; exit 1; fi && \
+          echo "Downloading ${browser} from $DOWNLOAD_URL" && \
+          curl -L -o /tmp/${browser}.zip "$DOWNLOAD_URL" && \
+          if [ $? -ne 0 ]; then echo "Failed to download ${browser}"; exit 1; fi && \
+          unzip -q /tmp/${browser}.zip -d "/ms-playwright/$(basename $(grep "Install location:" /tmp/${browser}-info.txt | cut -d':' -f2- | xargs))" && \
+          if [ $? -ne 0 ]; then echo "Failed to extract ${browser}"; exit 1; fi && \
+          chmod -R +x "/ms-playwright/$(basename $(grep "Install location:" /tmp/${browser}-info.txt | cut -d':' -f2- | xargs))" && \
+          rm /tmp/${browser}.zip`);
+        });
+        // Environment variables
+        const envVars = {
+            PLAYWRIGHT_BROWSERS_PATH: "/ms-playwright", // where playwright will find the browsers
+            PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: "1", // we already downloaded the browsers
+            PLAYWRIGHT_SKIP_BROWSER_VALIDATION: "1", // we already downloaded the browsers
+        };
+        if (!this.options.headless) {
+            instructions.push(`RUN echo '#!/bin/sh' > /usr/local/bin/xvfb-exec`, `RUN echo 'Xvfb :99 -screen 0 1024x768x24 &' >> /usr/local/bin/xvfb-exec`, `RUN echo 'exec "$@"' >> /usr/local/bin/xvfb-exec`, `RUN chmod +x /usr/local/bin/xvfb-exec`);
+            envVars.DISPLAY = ":99"; // Virtual display for the browsers
+        }
+        context.addLayer({
+            id: "playwright",
+            image: {
+                instructions,
+            },
+            deploy: {
+                env: envVars,
+                override: true,
+            },
+            dependencies: {
+                playwright: version,
+            },
+        });
+    }
+}
+//# sourceMappingURL=playwright.js.map

package/dist/esm/extensions/playwright.js.map

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

package/dist/esm/extensions/prisma.d.ts

@@ -1,51 +1,193 @@
 import { BuildManifest, BuildTarget } from "@trigger.dev/core/v3";
 import { BuildContext, BuildExtension } from "@trigger.dev/core/v3/build";
-export type PrismaExtensionOptions = {
-    schema: string;
-    migrate?: boolean;
-    version?: string;
-    /**
-     * Adds the `--sql` flag to the `prisma generate` command. This will generate the SQL files for the Prisma schema. Requires the `typedSql preview feature and prisma 5.19.0 or later.
-     */
-    typedSql?: boolean;
+export type PrismaLegacyModeExtensionOptions = {
     /**
-     * The client generator to use. Set this param to prevent all generators in the prisma schema from being generated.
+     * Legacy mode configuration for Prisma 5.x/6.x with the `prisma-client-js` provider.
      *
-     * @example
+     * **Use this mode when:**
+     * - Using Prisma 5.x or 6.x with `prisma-client-js` provider
+     * - You want automatic `prisma generate` during deployment
+     * - You need migration support
      *
-     * ### Prisma schema
+     * **Key features:**
+     * - Automatic client generation
+     * - Multi-file schema support (Prisma 6.7+)
+     * - Config file support (`prisma.config.ts`)
+     * - TypedSQL support
+     * - Automatic version detection
+     */
+    mode: "legacy";
+    /**
+     * Path to your Prisma schema file or directory.
      *
-     * ```prisma
-     * generator client {
-     *  provider = "prisma-client-js"
-     * }
+     * **Examples:**
+     * - Single file: `"./prisma/schema.prisma"`
+     * - Multi-file (Prisma 6.7+): `"./prisma"`
      *
-     * generator typegraphql {
-     *  provider = "typegraphql-prisma"
-     *  output = "./generated/type-graphql"
-     * }
-     * ```
+     * **Note:** Either `schema` or `configFile` must be specified, but not both.
+     */
+    schema?: string;
+    /**
+     * Path to your Prisma config file (`prisma.config.ts`).
      *
-     * ### PrismaExtension
+     * Uses `@prisma/config` to automatically extract schema and migrations paths.
+     * Requires Prisma 6+ with config file support.
      *
+     * **Example:**
      * ```ts
      * prismaExtension({
-     *  schema: "./prisma/schema.prisma",
-     *  clientGenerator: "client"
+     *   mode: "legacy",
+     *   configFile: "./prisma.config.ts",
+     *   migrate: true,
      * });
      * ```
+     *
+     * **Note:** Either `schema` or `configFile` must be specified, but not both.
+     */
+    configFile?: string;
+    /**
+     * Enable automatic database migrations during deployment.
+     *
+     * Runs `prisma migrate deploy` before generating the client.
+     * Requires `directUrlEnvVarName` to be set.
+     */
+    migrate?: boolean;
+    /**
+     * Override the auto-detected Prisma version.
+     *
+     * **Auto-detection:** Checks externals, then `@prisma/client` in node_modules, then `prisma` package.
+     */
+    version?: string;
+    /**
+     * Enable TypedSQL support. Adds `--sql` flag to `prisma generate`.
+     *
+     * Requires Prisma 5.19+ and `previewFeatures = ["typedSql"]` in your schema.
+     */
+    typedSql?: boolean;
+    /**
+     * Specify which generator to use when you have multiple generators.
+     *
+     * Adds `--generator=<name>` to only generate the specified generator.
+     * Useful for skipping extra generators like `typegraphql-prisma`.
      */
     clientGenerator?: string;
+    /**
+     * Environment variable name for the direct (unpooled) database connection.
+     *
+     * Required for migrations. Common values: `"DATABASE_URL_UNPOOLED"`, `"DIRECT_URL"`.
+     */
     directUrlEnvVarName?: string;
 };
-export declare function prismaExtension(options: PrismaExtensionOptions): PrismaExtension;
-export declare class PrismaExtension implements BuildExtension {
+export type PrismaEngineOnlyModeExtensionOptions = {
+    /**
+     * Engine-only mode for custom Prisma client output paths.
+     *
+     * **Use this mode when:**
+     * - You're using a custom output path for Prisma Client
+     * - You want to control when `prisma generate` runs
+     * - You run `prisma generate` in your build pipeline
+     *
+     * **What it does:**
+     * - Installs engine binaries only (no client generation)
+     * - Sets `PRISMA_QUERY_ENGINE_LIBRARY` and `PRISMA_QUERY_ENGINE_SCHEMA_ENGINE` env vars
+     * - Auto-detects version from filesystem
+     *
+     * **You must:** Run `prisma generate` yourself and include correct `binaryTargets` in your schema.
+     */
+    mode: "engine-only";
+    /**
+     * Prisma version to use. Auto-detected from `@prisma/client` or `prisma` package if omitted.
+     *
+     * **Recommended:** Specify explicitly for reproducible builds.
+     */
+    version?: string;
+    /**
+     * Binary target platform for Prisma engines.
+     *
+     * **Default:** `"debian-openssl-3.0.x"` (for Trigger.dev Cloud)
+     * **Local Docker on ARM:** `"linux-arm64-openssl-3.0.x"`
+     */
+    binaryTarget?: string;
+    /**
+     * Suppress progress messages during the build.
+     */
+    silent?: boolean;
+};
+export type PrismaEngineModernModeExtensionOptions = {
+    /**
+     * Modern mode for Prisma 6.16+ (with `prisma-client` provider) and Prisma 7.
+     *
+     * **Use this mode when:**
+     * - Using Prisma 6.16+ with `provider = "prisma-client"` and `engineType = "client"`
+     * - Using Prisma 7 beta or later
+     * - Using database adapters (e.g., `@prisma/adapter-pg`)
+     *
+     * **What it does:**
+     * - Marks `@prisma/client` as external (zero config)
+     * - Works with TypeScript-only client (no Rust binaries)
+     *
+     * **You must:** Run `prisma generate` yourself and install database adapters.
+     */
+    mode: "modern";
+};
+export type PrismaExtensionOptions = PrismaLegacyModeExtensionOptions | PrismaEngineOnlyModeExtensionOptions | PrismaEngineModernModeExtensionOptions;
+/**
+ * Prisma build extension for Trigger.dev deployments.
+ *
+ * **Three modes available:**
+ * - `"legacy"` - Prisma 5.x/6.x with `prisma-client-js`, automatic generation
+ * - `"engine-only"` - Custom output paths, manual generation control
+ * - `"modern"` - Prisma 6.16+/7.x with `prisma-client` provider
+ *
+ * @example Legacy mode (most common)
+ * ```ts
+ * prismaExtension({
+ *   mode: "legacy",
+ *   schema: "prisma/schema.prisma",
+ *   migrate: true,
+ *   typedSql: true,
+ * });
+ * ```
+ *
+ * @example Engine-only mode (custom output)
+ * ```ts
+ * prismaExtension({
+ *   mode: "engine-only",
+ *   version: "6.19.0",
+ * });
+ * ```
+ *
+ * @example Modern mode (Prisma 7)
+ * ```ts
+ * prismaExtension({
+ *   mode: "modern",
+ * });
+ * ```
+ */
+export declare function prismaExtension(options: PrismaExtensionOptions): BuildExtension;
+export declare class PrismaLegacyModeExtension implements BuildExtension {
     private options;
     moduleExternals: string[];
     readonly name = "PrismaExtension";
     private _resolvedSchemaPath?;
-    constructor(options: PrismaExtensionOptions);
+    private _loadedConfig?;
+    constructor(options: PrismaLegacyModeExtensionOptions);
     externalsForTarget(target: BuildTarget): string[];
     onBuildStart(context: BuildContext): Promise<void>;
     onBuildComplete(context: BuildContext, manifest: BuildManifest): Promise<void>;
 }
+export declare class PrismaEngineOnlyModeExtension implements BuildExtension {
+    private options;
+    readonly name = "PrismaEngineOnlyModeExtension";
+    private _binaryTarget;
+    constructor(options: PrismaEngineOnlyModeExtensionOptions);
+    installedPackagesForTarget(target: BuildTarget): string[];
+    onBuildComplete(context: BuildContext, manifest: BuildManifest): Promise<void>;
+}
+export declare class PrismaEngineModernModeExtension implements BuildExtension {
+    private options;
+    moduleExternals: string[];
+    readonly name = "PrismaEngineModernModeExtension";
+    constructor(options: PrismaEngineModernModeExtensionOptions);
+    externalsForTarget(target: BuildTarget): string[];
+}