@netlify/dev 2.0.0 → 2.1.0

package/README.md

@@ -0,0 +1,66 @@
+# @netlify/dev
+
+> [!WARNING] This module is under active development and does **not** yet support all Netlify platform features.
+
+`@netlify/dev` is a local emulator for the Netlify production environment. While it can be used directly by advanced
+users, it is primarily designed as a foundational library for higher-level tools like the
+[Netlify CLI](https://docs.netlify.com/cli/get-started/) and the
+[Netlify Vite Plugin](https://docs.netlify.com/integrations/vite/overview/).
+
+It provides a local request pipeline that mimics the Netlify platform’s request handling, including support for
+Functions, Blobs, Static files, and Redirects.
+
+## 🚧 Feature Support
+
+| Feature                | Supported |
+| ---------------------- | --------- |
+| Functions              | ✅ Yes    |
+| Edge Functions         | ❌ No     |
+| Blobs                  | ✅ Yes    |
+| Cache API              | ✅ Yes    |
+| Redirects and Rewrites | ✅ Yes    |
+| Headers                | ❌ No     |
+| Environment Variables  | ❌ No     |
+
+> Note: Missing features will be added incrementally. This module is **not** intended to be a full replacement for the
+> Netlify CLI.
+
+## 📦 Installation
+
+```bash
+npm install @netlify/dev
+```
+
+or
+
+```bash
+yarn add @netlify/dev
+```
+
+## 🚀 Usage
+
+You can use `@netlify/dev` to emulate the Netlify runtime in your own development tooling or custom integrations:
+
+```ts
+import { NetlifyDev } from '@netlify/dev'
+
+const devServer = new NetlifyDev({
+  functions: { enabled: true },
+  blobs: { enabled: true },
+  redirects: { enabled: true },
+  staticFiles: { enabled: true },
+})
+
+await devServer.start()
+
+const response = await devServer.handle(new Request('http://localhost:8888/path'))
+
+console.log(await response.text())
+
+await devServer.stop()
+```
+
+## 🧪 Contributing and feedback
+
+This module is **experimental**, and we welcome feedback and contributions. Feel free to open issues or pull requests if
+you encounter bugs or have suggestions.

package/dist/main.cjs

@@ -30,97 +30,70 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/main.ts
 var main_exports = {};
 __export(main_exports, {
-  handle: () => handle,
-  start: () => start
+  NetlifyDev: () => NetlifyDev
 });
 module.exports = __toCommonJS(main_exports);
-var import_node_path3 = __toESM(require("path"), 1);
-var import_node_process3 = __toESM(require("process"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
+var import_node_process2 = __toESM(require("process"), 1);
+var import_config = require("@netlify/config");
+var import_dev_utils = require("@netlify/dev-utils");
 var import_dev = require("@netlify/functions/dev");
 var import_redirects = require("@netlify/redirects");
 var import_static = require("@netlify/static");
 
-// src/lib/config.ts
-var import_node_path = __toESM(require("path"), 1);
-var import_node_process = __toESM(require("process"), 1);
-var import_config = require("@netlify/config");
-var import_dev_utils = require("@netlify/dev-utils");
-
 // src/lib/fs.ts
 var import_node_fs = require("fs");
-var isDirectory = async (path4) => {
+var isDirectory = async (path3) => {
   try {
-    const stat = await import_node_fs.promises.stat(path4);
+    const stat = await import_node_fs.promises.stat(path3);
     return stat.isDirectory();
   } catch {
   }
   return false;
 };
-var isFile = async (path4) => {
+var isFile = async (path3) => {
   try {
-    const stat = await import_node_fs.promises.stat(path4);
+    const stat = await import_node_fs.promises.stat(path3);
     return stat.isFile();
   } catch {
   }
   return false;
 };
 
-// src/lib/config.ts
-var getConfig = async ({
-  projectRoot
-}) => {
-  const token = await (0, import_dev_utils.getAPIToken)();
-  const state = new import_dev_utils.LocalState(projectRoot);
-  const siteID = state.get("siteId");
-  const configFilePath = import_node_path.default.resolve(projectRoot, "netlify.toml");
-  const configFileExists = await isFile(configFilePath);
-  const config = await (0, import_config.resolveConfig)({
-    config: configFileExists ? configFilePath : void 0,
-    repositoryRoot: projectRoot,
-    cwd: import_node_process.default.cwd(),
-    context: "dev",
-    siteId: siteID,
-    token,
-    mode: "cli",
-    offline: !siteID
-  });
-  return { config, siteID };
-};
-
 // src/lib/runtime.ts
-var import_node_path2 = __toESM(require("path"), 1);
-var import_node_process2 = __toESM(require("process"), 1);
+var import_node_path = __toESM(require("path"), 1);
+var import_node_process = __toESM(require("process"), 1);
 var import_server = require("@netlify/blobs/server");
 var import_runtime = require("@netlify/runtime");
 var restoreEnvironment = (snapshot) => {
   for (const key in snapshot) {
     if (snapshot[key] === void 0) {
-      delete import_node_process2.default.env[key];
+      delete import_node_process.default.env[key];
     } else {
-      import_node_process2.default.env[key] = snapshot[key];
+      import_node_process.default.env[key] = snapshot[key];
     }
   }
 };
 var getRuntime = async ({ blobs, deployID, projectRoot, siteID }) => {
   const blobsToken = Math.random().toString().slice(2);
   const blobsServer = blobs ? new import_server.BlobsServer({
-    directory: import_node_path2.default.join(projectRoot, ".netlify", "blobs-serve"),
+    directory: import_node_path.default.join(projectRoot, ".netlify", "blobs-serve"),
     token: blobsToken
   }) : null;
   const blobsServerDetails = await blobsServer?.start();
   const envSnapshot = {};
   const env = {
     delete: (key) => {
-      envSnapshot[key] = envSnapshot[key] || import_node_process2.default.env[key];
-      delete import_node_process2.default.env[key];
+      envSnapshot[key] = envSnapshot[key] || import_node_process.default.env[key];
+      delete import_node_process.default.env[key];
     },
-    get: (key) => import_node_process2.default.env[key],
-    has: (key) => Boolean(import_node_process2.default.env[key]),
+    get: (key) => import_node_process.default.env[key],
+    has: (key) => Boolean(import_node_process.default.env[key]),
     set: (key, value) => {
-      envSnapshot[key] = envSnapshot[key] || import_node_process2.default.env[key];
-      import_node_process2.default.env[key] = value;
+      envSnapshot[key] = envSnapshot[key] || import_node_process.default.env[key];
+      import_node_process.default.env[key] = value;
     },
-    toObject: () => import_node_process2.default.env
+    toObject: () => import_node_process.default.env
   };
   (0, import_runtime.startRuntime)({
     blobs: blobsServerDetails ? {
@@ -147,91 +120,115 @@ var getRuntime = async ({ blobs, deployID, projectRoot, siteID }) => {
 };
 
 // src/main.ts
-var defaultFeatures = {
-  blobs: true,
-  functions: true,
-  redirects: true,
-  static: true
-};
 var notFoundHandler = async () => new Response("Not found", { status: 404 });
-var handle = async (request, options) => {
-  const { features = defaultFeatures, projectRoot = import_node_process3.default.cwd() } = options ?? {};
-  const { config, siteID } = await getConfig({ projectRoot }) ?? {};
-  const userFunctionsPath = config?.config.functionsDirectory ?? import_node_path3.default.join(projectRoot, "netlify/functions");
-  const userFunctionsPathExists = await isDirectory(userFunctionsPath);
-  const functions = features.functions ? new import_dev.FunctionsHandler({
-    config,
-    destPath: import_node_path3.default.join(projectRoot, ".netlify", "functions-serve"),
-    projectRoot,
-    settings: {},
-    siteId: siteID,
-    timeouts: {},
-    userFunctionsPath: userFunctionsPathExists ? userFunctionsPath : void 0
-  }) : null;
-  const redirects = features.redirects ? new import_redirects.RedirectsHandler({
-    configPath: config?.configPath,
-    configRedirects: config?.config.redirects,
-    jwtRoleClaim: "",
-    jwtSecret: "",
-    notFoundHandler,
-    projectDir: projectRoot
-  }) : null;
-  const staticFiles = features.static ? new import_static.StaticHandler({
-    directory: config?.config.build.publish ?? projectRoot
-  }) : null;
-  const runtime = await getRuntime({
-    blobs: Boolean(features.blobs),
-    deployID: "0",
-    projectRoot,
-    siteID: siteID ?? "0"
-  });
-  const functionMatch = await functions?.match(request);
-  if (functionMatch) {
-    if (functionMatch.preferStatic) {
-      const staticMatch2 = await staticFiles?.match(request);
-      if (staticMatch2) {
-        return staticMatch2.handle();
+var NetlifyDev = class {
+  #apiToken;
+  #config;
+  #features;
+  #logger;
+  #projectRoot;
+  #runtime;
+  #siteID;
+  constructor(options) {
+    this.#features = {
+      blobs: options.blobs?.enabled !== false,
+      functions: options.functions?.enabled !== false,
+      redirects: options.redirects?.enabled !== false,
+      static: options.staticFiles?.enabled !== false
+    };
+    this.#logger = options.logger ?? globalThis.console;
+    this.#projectRoot = options.projectRoot ?? import_node_process2.default.cwd();
+  }
+  async getConfig() {
+    const configFilePath = import_node_path2.default.resolve(this.#projectRoot, "netlify.toml");
+    const configFileExists = await isFile(configFilePath);
+    const config = await (0, import_config.resolveConfig)({
+      config: configFileExists ? configFilePath : void 0,
+      repositoryRoot: this.#projectRoot,
+      cwd: import_node_process2.default.cwd(),
+      context: "dev",
+      siteId: this.#siteID,
+      token: this.#apiToken,
+      mode: "cli",
+      offline: !this.#siteID
+    });
+    return config;
+  }
+  async handle(request) {
+    const userFunctionsPath = this.#config?.config.functionsDirectory ?? import_node_path2.default.join(this.#projectRoot, "netlify/functions");
+    const userFunctionsPathExists = await isDirectory(userFunctionsPath);
+    const functions = this.#features.functions ? new import_dev.FunctionsHandler({
+      config: this.#config,
+      destPath: import_node_path2.default.join(this.#projectRoot, ".netlify", "functions-serve"),
+      projectRoot: this.#projectRoot,
+      settings: {},
+      siteId: this.#siteID,
+      timeouts: {},
+      userFunctionsPath: userFunctionsPathExists ? userFunctionsPath : void 0
+    }) : null;
+    const redirects = this.#features.redirects ? new import_redirects.RedirectsHandler({
+      configPath: this.#config?.configPath,
+      configRedirects: this.#config?.config.redirects,
+      jwtRoleClaim: "",
+      jwtSecret: "",
+      notFoundHandler,
+      projectDir: this.#projectRoot
+    }) : null;
+    const staticFiles = this.#features.static ? new import_static.StaticHandler({
+      directory: this.#config?.config.build.publish ?? this.#projectRoot
+    }) : null;
+    const functionMatch = await functions?.match(request);
+    if (functionMatch) {
+      if (functionMatch.preferStatic) {
+        const staticMatch2 = await staticFiles?.match(request);
+        if (staticMatch2) {
+          return staticMatch2.handle();
+        }
       }
+      return functionMatch.handle(request);
     }
-    return functionMatch.handle(request);
-  }
-  const redirectMatch = await redirects?.match(request);
-  if (redirectMatch) {
-    const functionMatch2 = await functions?.match(new Request(redirectMatch.target));
-    if (functionMatch2 && !functionMatch2.preferStatic) {
-      return functionMatch2.handle(request);
+    const redirectMatch = await redirects?.match(request);
+    if (redirectMatch) {
+      const functionMatch2 = await functions?.match(new Request(redirectMatch.target));
+      if (functionMatch2 && !functionMatch2.preferStatic) {
+        return functionMatch2.handle(request);
+      }
+      const response = await redirects?.handle(request, redirectMatch, async (maybeStaticFile) => {
+        const staticMatch2 = await staticFiles?.match(maybeStaticFile);
+        return staticMatch2?.handle;
+      });
+      if (response) {
+        return response;
+      }
     }
-    const response = await redirects?.handle(request, redirectMatch, async (maybeStaticFile) => {
-      const staticMatch2 = await staticFiles?.match(maybeStaticFile);
-      return staticMatch2?.handle;
-    });
-    if (response) {
-      return response;
+    const staticMatch = await staticFiles?.match(request);
+    if (staticMatch) {
+      return staticMatch.handle();
     }
   }
-  const staticMatch = await staticFiles?.match(request);
-  if (staticMatch) {
-    return staticMatch.handle();
+  get siteIsLinked() {
+    return Boolean(this.#siteID);
+  }
+  async start() {
+    await (0, import_dev_utils.ensureNetlifyIgnore)(this.#projectRoot, this.#logger);
+    const apiToken = await (0, import_dev_utils.getAPIToken)();
+    this.#apiToken = apiToken;
+    const state = new import_dev_utils.LocalState(this.#projectRoot);
+    const siteID = state.get("siteId");
+    this.#siteID = siteID;
+    this.#config = await this.getConfig();
+    this.#runtime = await getRuntime({
+      blobs: Boolean(this.#features.blobs),
+      deployID: "0",
+      projectRoot: this.#projectRoot,
+      siteID: siteID ?? "0"
+    });
+  }
+  async stop() {
+    await this.#runtime?.stop();
   }
-  await runtime.stop();
-};
-var start = async (options) => {
-  const { projectRoot = import_node_process3.default.cwd() } = options ?? {};
-  const { siteID } = await getConfig({ projectRoot }) ?? {};
-  const runtime = await getRuntime({
-    blobs: true,
-    deployID: "0",
-    projectRoot,
-    siteID: siteID ?? "0"
-  });
-  return {
-    stop: async () => {
-      await runtime.stop();
-    }
-  };
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  handle,
-  start
+  NetlifyDev
 });

package/dist/main.d.cts

@@ -1,19 +1,49 @@
+import { Logger } from '@netlify/dev-utils';
+
 interface Features {
-    blobs?: boolean;
-    functions?: boolean;
-    redirects?: boolean;
-    static?: boolean;
+    /**
+     * Configuration options for Netlify Blobs.
+     *
+     * {@link} https://docs.netlify.com/blobs/overview/
+     */
+    blobs?: {
+        enabled: boolean;
+    };
+    /**
+     * Configuration options for Netlify Functions.
+     *
+     * {@link} https://docs.netlify.com/functions/overview/
+     */
+    functions?: {
+        enabled: boolean;
+    };
+    /**
+     * Configuration options for Netlify redirects and rewrites.
+     *
+     * {@link} https://docs.netlify.com/routing/redirects/
+     */
+    redirects?: {
+        enabled: boolean;
+    };
+    /**
+     * Configuration options for serving static files.
+     */
+    staticFiles?: {
+        enabled: boolean;
+    };
 }
-interface HandleOptions {
-    features?: Features;
+interface NetlifyDevOptions extends Features {
+    logger?: Logger;
     projectRoot?: string;
 }
-declare const handle: (request: Request, options?: HandleOptions) => Promise<Response | undefined>;
-interface StartOptions {
-    projectRoot?: string;
+declare class NetlifyDev {
+    #private;
+    constructor(options: NetlifyDevOptions);
+    private getConfig;
+    handle(request: Request): Promise<Response | undefined>;
+    get siteIsLinked(): boolean;
+    start(): Promise<void>;
+    stop(): Promise<void>;
 }
-declare const start: (options?: StartOptions) => Promise<{
-    stop: () => Promise<void>;
-}>;
 
-export { handle, start };
+export { type Features, NetlifyDev };

package/dist/main.d.ts

@@ -1,19 +1,49 @@
+import { Logger } from '@netlify/dev-utils';
+
 interface Features {
-    blobs?: boolean;
-    functions?: boolean;
-    redirects?: boolean;
-    static?: boolean;
+    /**
+     * Configuration options for Netlify Blobs.
+     *
+     * {@link} https://docs.netlify.com/blobs/overview/
+     */
+    blobs?: {
+        enabled: boolean;
+    };
+    /**
+     * Configuration options for Netlify Functions.
+     *
+     * {@link} https://docs.netlify.com/functions/overview/
+     */
+    functions?: {
+        enabled: boolean;
+    };
+    /**
+     * Configuration options for Netlify redirects and rewrites.
+     *
+     * {@link} https://docs.netlify.com/routing/redirects/
+     */
+    redirects?: {
+        enabled: boolean;
+    };
+    /**
+     * Configuration options for serving static files.
+     */
+    staticFiles?: {
+        enabled: boolean;
+    };
 }
-interface HandleOptions {
-    features?: Features;
+interface NetlifyDevOptions extends Features {
+    logger?: Logger;
     projectRoot?: string;
 }
-declare const handle: (request: Request, options?: HandleOptions) => Promise<Response | undefined>;
-interface StartOptions {
-    projectRoot?: string;
+declare class NetlifyDev {
+    #private;
+    constructor(options: NetlifyDevOptions);
+    private getConfig;
+    handle(request: Request): Promise<Response | undefined>;
+    get siteIsLinked(): boolean;
+    start(): Promise<void>;
+    stop(): Promise<void>;
 }
-declare const start: (options?: StartOptions) => Promise<{
-    stop: () => Promise<void>;
-}>;
 
-export { handle, start };
+export { type Features, NetlifyDev };

package/dist/main.js

@@ -1,91 +1,65 @@
 // src/main.ts
-import path3 from "node:path";
-import process3 from "node:process";
+import path2 from "node:path";
+import process2 from "node:process";
+import { resolveConfig } from "@netlify/config";
+import { ensureNetlifyIgnore, getAPIToken, LocalState } from "@netlify/dev-utils";
 import { FunctionsHandler } from "@netlify/functions/dev";
 import { RedirectsHandler } from "@netlify/redirects";
 import { StaticHandler } from "@netlify/static";
 
-// src/lib/config.ts
-import path from "node:path";
-import process from "node:process";
-import { resolveConfig } from "@netlify/config";
-import { getAPIToken, LocalState } from "@netlify/dev-utils";
-
 // src/lib/fs.ts
 import { promises as fs } from "node:fs";
-var isDirectory = async (path4) => {
+var isDirectory = async (path3) => {
   try {
-    const stat = await fs.stat(path4);
+    const stat = await fs.stat(path3);
     return stat.isDirectory();
   } catch {
   }
   return false;
 };
-var isFile = async (path4) => {
+var isFile = async (path3) => {
   try {
-    const stat = await fs.stat(path4);
+    const stat = await fs.stat(path3);
     return stat.isFile();
   } catch {
   }
   return false;
 };
 
-// src/lib/config.ts
-var getConfig = async ({
-  projectRoot
-}) => {
-  const token = await getAPIToken();
-  const state = new LocalState(projectRoot);
-  const siteID = state.get("siteId");
-  const configFilePath = path.resolve(projectRoot, "netlify.toml");
-  const configFileExists = await isFile(configFilePath);
-  const config = await resolveConfig({
-    config: configFileExists ? configFilePath : void 0,
-    repositoryRoot: projectRoot,
-    cwd: process.cwd(),
-    context: "dev",
-    siteId: siteID,
-    token,
-    mode: "cli",
-    offline: !siteID
-  });
-  return { config, siteID };
-};
-
 // src/lib/runtime.ts
-import path2 from "node:path";
-import process2 from "node:process";
+import path from "node:path";
+import process from "node:process";
 import { BlobsServer } from "@netlify/blobs/server";
 import { startRuntime } from "@netlify/runtime";
 var restoreEnvironment = (snapshot) => {
   for (const key in snapshot) {
     if (snapshot[key] === void 0) {
-      delete process2.env[key];
+      delete process.env[key];
     } else {
-      process2.env[key] = snapshot[key];
+      process.env[key] = snapshot[key];
     }
   }
 };
 var getRuntime = async ({ blobs, deployID, projectRoot, siteID }) => {
   const blobsToken = Math.random().toString().slice(2);
   const blobsServer = blobs ? new BlobsServer({
-    directory: path2.join(projectRoot, ".netlify", "blobs-serve"),
+    directory: path.join(projectRoot, ".netlify", "blobs-serve"),
     token: blobsToken
   }) : null;
   const blobsServerDetails = await blobsServer?.start();
   const envSnapshot = {};
   const env = {
     delete: (key) => {
-      envSnapshot[key] = envSnapshot[key] || process2.env[key];
-      delete process2.env[key];
+      envSnapshot[key] = envSnapshot[key] || process.env[key];
+      delete process.env[key];
     },
-    get: (key) => process2.env[key],
-    has: (key) => Boolean(process2.env[key]),
+    get: (key) => process.env[key],
+    has: (key) => Boolean(process.env[key]),
     set: (key, value) => {
-      envSnapshot[key] = envSnapshot[key] || process2.env[key];
-      process2.env[key] = value;
+      envSnapshot[key] = envSnapshot[key] || process.env[key];
+      process.env[key] = value;
     },
-    toObject: () => process2.env
+    toObject: () => process.env
   };
   startRuntime({
     blobs: blobsServerDetails ? {
@@ -112,90 +86,114 @@ var getRuntime = async ({ blobs, deployID, projectRoot, siteID }) => {
 };
 
 // src/main.ts
-var defaultFeatures = {
-  blobs: true,
-  functions: true,
-  redirects: true,
-  static: true
-};
 var notFoundHandler = async () => new Response("Not found", { status: 404 });
-var handle = async (request, options) => {
-  const { features = defaultFeatures, projectRoot = process3.cwd() } = options ?? {};
-  const { config, siteID } = await getConfig({ projectRoot }) ?? {};
-  const userFunctionsPath = config?.config.functionsDirectory ?? path3.join(projectRoot, "netlify/functions");
-  const userFunctionsPathExists = await isDirectory(userFunctionsPath);
-  const functions = features.functions ? new FunctionsHandler({
-    config,
-    destPath: path3.join(projectRoot, ".netlify", "functions-serve"),
-    projectRoot,
-    settings: {},
-    siteId: siteID,
-    timeouts: {},
-    userFunctionsPath: userFunctionsPathExists ? userFunctionsPath : void 0
-  }) : null;
-  const redirects = features.redirects ? new RedirectsHandler({
-    configPath: config?.configPath,
-    configRedirects: config?.config.redirects,
-    jwtRoleClaim: "",
-    jwtSecret: "",
-    notFoundHandler,
-    projectDir: projectRoot
-  }) : null;
-  const staticFiles = features.static ? new StaticHandler({
-    directory: config?.config.build.publish ?? projectRoot
-  }) : null;
-  const runtime = await getRuntime({
-    blobs: Boolean(features.blobs),
-    deployID: "0",
-    projectRoot,
-    siteID: siteID ?? "0"
-  });
-  const functionMatch = await functions?.match(request);
-  if (functionMatch) {
-    if (functionMatch.preferStatic) {
-      const staticMatch2 = await staticFiles?.match(request);
-      if (staticMatch2) {
-        return staticMatch2.handle();
+var NetlifyDev = class {
+  #apiToken;
+  #config;
+  #features;
+  #logger;
+  #projectRoot;
+  #runtime;
+  #siteID;
+  constructor(options) {
+    this.#features = {
+      blobs: options.blobs?.enabled !== false,
+      functions: options.functions?.enabled !== false,
+      redirects: options.redirects?.enabled !== false,
+      static: options.staticFiles?.enabled !== false
+    };
+    this.#logger = options.logger ?? globalThis.console;
+    this.#projectRoot = options.projectRoot ?? process2.cwd();
+  }
+  async getConfig() {
+    const configFilePath = path2.resolve(this.#projectRoot, "netlify.toml");
+    const configFileExists = await isFile(configFilePath);
+    const config = await resolveConfig({
+      config: configFileExists ? configFilePath : void 0,
+      repositoryRoot: this.#projectRoot,
+      cwd: process2.cwd(),
+      context: "dev",
+      siteId: this.#siteID,
+      token: this.#apiToken,
+      mode: "cli",
+      offline: !this.#siteID
+    });
+    return config;
+  }
+  async handle(request) {
+    const userFunctionsPath = this.#config?.config.functionsDirectory ?? path2.join(this.#projectRoot, "netlify/functions");
+    const userFunctionsPathExists = await isDirectory(userFunctionsPath);
+    const functions = this.#features.functions ? new FunctionsHandler({
+      config: this.#config,
+      destPath: path2.join(this.#projectRoot, ".netlify", "functions-serve"),
+      projectRoot: this.#projectRoot,
+      settings: {},
+      siteId: this.#siteID,
+      timeouts: {},
+      userFunctionsPath: userFunctionsPathExists ? userFunctionsPath : void 0
+    }) : null;
+    const redirects = this.#features.redirects ? new RedirectsHandler({
+      configPath: this.#config?.configPath,
+      configRedirects: this.#config?.config.redirects,
+      jwtRoleClaim: "",
+      jwtSecret: "",
+      notFoundHandler,
+      projectDir: this.#projectRoot
+    }) : null;
+    const staticFiles = this.#features.static ? new StaticHandler({
+      directory: this.#config?.config.build.publish ?? this.#projectRoot
+    }) : null;
+    const functionMatch = await functions?.match(request);
+    if (functionMatch) {
+      if (functionMatch.preferStatic) {
+        const staticMatch2 = await staticFiles?.match(request);
+        if (staticMatch2) {
+          return staticMatch2.handle();
+        }
       }
+      return functionMatch.handle(request);
     }
-    return functionMatch.handle(request);
-  }
-  const redirectMatch = await redirects?.match(request);
-  if (redirectMatch) {
-    const functionMatch2 = await functions?.match(new Request(redirectMatch.target));
-    if (functionMatch2 && !functionMatch2.preferStatic) {
-      return functionMatch2.handle(request);
+    const redirectMatch = await redirects?.match(request);
+    if (redirectMatch) {
+      const functionMatch2 = await functions?.match(new Request(redirectMatch.target));
+      if (functionMatch2 && !functionMatch2.preferStatic) {
+        return functionMatch2.handle(request);
+      }
+      const response = await redirects?.handle(request, redirectMatch, async (maybeStaticFile) => {
+        const staticMatch2 = await staticFiles?.match(maybeStaticFile);
+        return staticMatch2?.handle;
+      });
+      if (response) {
+        return response;
+      }
     }
-    const response = await redirects?.handle(request, redirectMatch, async (maybeStaticFile) => {
-      const staticMatch2 = await staticFiles?.match(maybeStaticFile);
-      return staticMatch2?.handle;
-    });
-    if (response) {
-      return response;
+    const staticMatch = await staticFiles?.match(request);
+    if (staticMatch) {
+      return staticMatch.handle();
     }
   }
-  const staticMatch = await staticFiles?.match(request);
-  if (staticMatch) {
-    return staticMatch.handle();
+  get siteIsLinked() {
+    return Boolean(this.#siteID);
+  }
+  async start() {
+    await ensureNetlifyIgnore(this.#projectRoot, this.#logger);
+    const apiToken = await getAPIToken();
+    this.#apiToken = apiToken;
+    const state = new LocalState(this.#projectRoot);
+    const siteID = state.get("siteId");
+    this.#siteID = siteID;
+    this.#config = await this.getConfig();
+    this.#runtime = await getRuntime({
+      blobs: Boolean(this.#features.blobs),
+      deployID: "0",
+      projectRoot: this.#projectRoot,
+      siteID: siteID ?? "0"
+    });
+  }
+  async stop() {
+    await this.#runtime?.stop();
   }
-  await runtime.stop();
-};
-var start = async (options) => {
-  const { projectRoot = process3.cwd() } = options ?? {};
-  const { siteID } = await getConfig({ projectRoot }) ?? {};
-  const runtime = await getRuntime({
-    blobs: true,
-    deployID: "0",
-    projectRoot,
-    siteID: siteID ?? "0"
-  });
-  return {
-    stop: async () => {
-      await runtime.stop();
-    }
-  };
 };
 export {
-  handle,
-  start
+  NetlifyDev
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netlify/dev",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Local development emulation for Netlify",
   "type": "module",
   "engines": {
@@ -50,12 +50,12 @@
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "@netlify/blobs": "9.0.0",
+    "@netlify/blobs": "9.0.1",
     "@netlify/config": "^22.0.0",
-    "@netlify/dev-utils": "2.0.0",
-    "@netlify/functions": "3.1.3",
-    "@netlify/redirects": "1.1.1",
-    "@netlify/runtime": "2.0.0",
-    "@netlify/static": "1.1.1"
+    "@netlify/dev-utils": "2.1.0",
+    "@netlify/functions": "3.1.4",
+    "@netlify/redirects": "1.1.2",
+    "@netlify/runtime": "2.1.0",
+    "@netlify/static": "1.1.2"
   }
 }