cloud-run-functions 0.1.3 → 0.2.0

package/dist/chunk-MOB3GBJW.js

@@ -0,0 +1,109 @@
+import {
+  dedent
+} from "./chunk-SPF3AMMV.js";
+
+// src/common/functionFilter.ts
+import path from "node:path";
+function getFunctionFilter(options) {
+  const functionGlobs = [];
+  const functionSuffixes = /* @__PURE__ */ new Set();
+  const requiredSuffix = options.entrySuffix?.replace(/^\.?/, ".") ?? "";
+  for (const glob of options.globs ?? ["**/*"]) {
+    let ext = path.extname(glob);
+    if (ext) {
+      functionSuffixes.add(requiredSuffix + ext);
+      functionGlobs.push(
+        requiredSuffix ? glob.replace(ext, requiredSuffix + ext) : glob
+      );
+      continue;
+    }
+    for (ext of options.extensions ?? [".ts", ".js"]) {
+      ext = requiredSuffix + ext;
+      functionSuffixes.add(ext);
+      functionGlobs.push(glob + ext);
+    }
+  }
+  const suffixPattern = new RegExp(
+    `(${Array.from(functionSuffixes, (e) => e.replace(/\./g, "\\.")).sort((a, b) => b.length - a.length).join("|")})$`
+  );
+  return {
+    globs: functionGlobs,
+    suffixPattern
+  };
+}
+
+// src/config/index.ts
+import * as z2 from "@zod/mini";
+import Joycon from "joycon";
+import path2 from "node:path";
+
+// src/config/schema.ts
+import * as z from "@zod/mini";
+var configSchema = z.partial(
+  z.interface({
+    root: z.string().register(z.globalRegistry, {
+      description: dedent`
+        The base directory when searching for entry points.
+
+        Defaults to the config directory (or if no config file is found, the current working directory).
+      `
+    }),
+    globs: z.array(z.string()).register(z.globalRegistry, {
+      description: dedent`
+        The globs determine which directories are searched for entry points. Only ".ts" and ".js" files are matched, so you're not required to include them in the globs.
+
+        By default all directories in the "root" are searched.
+      `
+    }),
+    extensions: z.array(z.string()).register(z.globalRegistry, {
+      description: dedent`
+        The extensions to match for entry points.
+
+        @default [".ts", ".js"]
+      `
+    }),
+    entrySuffix: z.string().register(z.globalRegistry, {
+      description: dedent`
+        The entry suffix should be a string like ".task" or ".function" which must be present in the file name (before the extension) or else that file will be ignored when scanning for entry points.
+
+        It can also be an empty string.
+      `
+    }),
+    adapter: z.enum(["hattip", "node"]).register(z.globalRegistry, {
+      description: dedent`
+        The adapter wraps your Cloud Run functions at runtime, allowing you to write them with a platform-agnostic HTTP framework, like Hattip.
+
+        Set this to "node" to skip using an adapter, in which case, your functions should conform to what @google-cloud/functions-framework expects.
+
+        @default "node"
+      `
+    }),
+    maxInstanceConcurrency: z.union([z.number(), z.record(z.string(), z.number())]).register(z.globalRegistry, {
+      description: dedent`
+          The maximum number of instances (per function) that can be run concurrently. You can either set the same limit for all functions or set a different limit for each function.
+
+          @default 5
+        `
+    })
+  })
+);
+
+// src/config/index.ts
+var joycon = new Joycon();
+function loadConfig(cwd) {
+  const result = joycon.loadSync(["crf.config.json"], cwd);
+  if (!result.path) {
+    return {
+      configDir: null
+    };
+  }
+  return {
+    ...z2.parse(configSchema, result.data),
+    configDir: path2.dirname(result.path)
+  };
+}
+
+export {
+  getFunctionFilter,
+  loadConfig
+};

package/dist/chunk-NINUPPZA.js

@@ -0,0 +1,122 @@
+import {
+  getFunctionFilter,
+  loadConfig
+} from "./chunk-MOB3GBJW.js";
+
+// src/tools/build.ts
+import esbuild from "esbuild";
+import { findUpSync } from "find-up-simple";
+import fs from "node:fs";
+import path from "node:path";
+import { glob } from "tinyglobby";
+var virtualModuleId = "virtual:cloud-run-functions";
+var virtualModuleNamespace = "crf-functions";
+async function build(root, { define, outdir } = {}) {
+  const workingDir = process.cwd();
+  const searchDir = path.resolve(workingDir, root ?? "");
+  const config = loadConfig(searchDir);
+  const functionsRoot = config.configDir ? path.resolve(config.configDir, config.root ?? "") : searchDir;
+  const functionFilter = getFunctionFilter(config);
+  const adapter = config.adapter ?? "node";
+  const entries = await glob(functionFilter.globs, {
+    cwd: functionsRoot,
+    onlyFiles: true
+  });
+  const entryPoints = Array.from(
+    new Set(entries.map((entry) => entry.split(path.sep).join("/")))
+  );
+  const routes = entryPoints.map((entry) => {
+    const name = entry.replace(functionFilter.suffixPattern, "");
+    return {
+      entry,
+      name,
+      path: "/" + name
+    };
+  }).sort((a, b) => a.path.localeCompare(b.path));
+  const seenPaths = /* @__PURE__ */ new Set();
+  for (const route of routes) {
+    if (seenPaths.has(route.path)) {
+      throw new Error(`Duplicate route detected: ${route.path}`);
+    }
+    seenPaths.add(route.path);
+  }
+  const outputDir = path.resolve(workingDir, outdir ?? "dist");
+  fs.mkdirSync(outputDir, { recursive: true });
+  const packageDir = findUpSync("dist", {
+    cwd: import.meta.dirname,
+    type: "directory"
+  });
+  if (!packageDir) {
+    throw new Error("Unable to locate the package dist directory.");
+  }
+  const source = path.join(packageDir, "targets/build.js");
+  const outfile = path.join(outputDir, "index.js");
+  const result = await esbuild.build({
+    entryPoints: [source],
+    absWorkingDir: functionsRoot,
+    outfile,
+    define,
+    bundle: true,
+    format: "cjs",
+    platform: "node",
+    packages: "bundle",
+    sourcemap: true,
+    sourcesContent: false,
+    logOverride: {
+      "empty-glob": "silent"
+    },
+    plugins: [
+      {
+        name: "crf-virtual-functions",
+        setup(build2) {
+          const filter = new RegExp(
+            `^${virtualModuleId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}$`
+          );
+          build2.onResolve({ filter }, () => ({
+            path: virtualModuleId,
+            namespace: virtualModuleNamespace
+          }));
+          build2.onLoad({ filter: /.*/, namespace: virtualModuleNamespace }, () => ({
+            contents: createVirtualModule({
+              routes,
+              adapter
+            }),
+            loader: "js",
+            resolveDir: functionsRoot
+          }));
+        }
+      }
+    ],
+    external: adapter === "hattip" ? [] : ["@hattip/adapter-node"]
+  });
+  console.log(
+    `[esbuild] Bundled ${routes.length} function${routes.length === 1 ? "" : "s"} into ${outfile}`
+  );
+  return result;
+}
+function createVirtualModule({
+  routes,
+  adapter
+}) {
+  const imports = routes.map((route, index) => {
+    const importPath = route.entry.startsWith(".") ? route.entry : `./${route.entry}`;
+    return `import * as route${index} from ${JSON.stringify(importPath)};`;
+  });
+  const routeEntries = routes.map(
+    (route, index) => `  { name: ${JSON.stringify(route.name)}, path: ${JSON.stringify(
+      route.path
+    )}, module: route${index} },`
+  );
+  return [
+    ...imports,
+    `export const adapter = ${JSON.stringify(adapter)};`,
+    "export const routes = [",
+    ...routeEntries,
+    "];",
+    ""
+  ].join("\n");
+}
+
+export {
+  build
+};

package/dist/chunk-PFVLROGP.js

@@ -0,0 +1,29 @@
+// src/tools/preview.ts
+import { findUpSync } from "find-up-simple";
+import path from "node:path";
+import $ from "picospawn";
+function preview({ outDir, ...options } = {}) {
+  const packageDir = findUpSync("dist", {
+    cwd: import.meta.dirname,
+    type: "directory"
+  });
+  const binDir = path.resolve(packageDir, "../node_modules/.bin");
+  const sourceDir = path.resolve(process.cwd(), outDir ?? "dist");
+  const source = path.join(sourceDir, "index.js");
+  return $(
+    "functions-framework --target=build --source %s",
+    [source],
+    {
+      stdio: "inherit",
+      ...options,
+      env: {
+        ...options.env ?? process.env,
+        PATH: `${binDir}:${process.env.PATH}`
+      }
+    }
+  );
+}
+
+export {
+  preview
+};

package/dist/chunk-SPF3AMMV.js

@@ -0,0 +1,82 @@
+// node_modules/.pnpm/radashi@12.4.0/node_modules/radashi/dist/radashi.js
+function objectify(array, getKey, getValue = (item) => item) {
+  return array.reduce(
+    (acc, item) => {
+      acc[getKey(item)] = getValue(item);
+      return acc;
+    },
+    {}
+  );
+}
+var TimeoutError = class extends Error {
+  constructor(message) {
+    super(message ?? "Operation timed out");
+    this.name = "TimeoutError";
+  }
+};
+function timeout(ms, error) {
+  return new Promise(
+    (_, reject) => setTimeout(
+      () => reject(isFunction(error) ? error() : new TimeoutError(error)),
+      ms
+    )
+  );
+}
+async function toResult(promise) {
+  try {
+    const result = await promise;
+    return [void 0, result];
+  } catch (error) {
+    if (isError(error)) {
+      return [error, void 0];
+    }
+    throw error;
+  }
+}
+function dedent(text, ...values) {
+  var _a;
+  if (isArray(text)) {
+    if (values.length > 0) {
+      return dedent(
+        text.reduce((acc, input, i) => {
+          var _a2;
+          let value = String(values[i] ?? "");
+          const indent2 = value.includes("\n") && ((_a2 = input.match(/[ \t]*(?=[^\n]*$)/)) == null ? void 0 : _a2[0]);
+          if (indent2) {
+            value = value.replace(/\n(?=[^\n]*?\S)/g, "\n" + indent2);
+          }
+          return acc + input + value;
+        }, "")
+      );
+    }
+    text = text[0];
+  }
+  const indent = values[0] ?? ((_a = text.match(/^[ \t]*(?=\S)/m)) == null ? void 0 : _a[0]);
+  const output = indent ? text.replace(new RegExp(`^${indent}`, "gm"), "") : text;
+  return output.replace(/^[ \t]*\n|\n[ \t]*$/g, "");
+}
+var isArray = /* @__PURE__ */ (() => Array.isArray)();
+var asyncIteratorSymbol = (
+  /* c8 ignore next */
+  Symbol.asyncIterator || Symbol.for("Symbol.asyncIterator")
+);
+function isError(value) {
+  return isTagged(value, "[object Error]");
+}
+function isFunction(value) {
+  return typeof value === "function";
+}
+function isNumber(value) {
+  return typeof value === "number" && !Number.isNaN(value);
+}
+function isTagged(value, tag) {
+  return Object.prototype.toString.call(value) === tag;
+}
+
+export {
+  objectify,
+  timeout,
+  toResult,
+  dedent,
+  isNumber
+};

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { BuildOptions, BundleOptions, build } from './tools/build.js';
 export { DevOptions, dev } from './tools/dev.js';
+export { PreviewOptions, preview } from './tools/preview.js';
+import 'esbuild';
 import 'picospawn';
-import './tools/build.js';

package/dist/index.js

@@ -1,6 +1,16 @@
+import {
+  build
+} from "./chunk-NINUPPZA.js";
+import "./chunk-MOB3GBJW.js";
+import "./chunk-SPF3AMMV.js";
 import {
   dev
 } from "./chunk-DG37B63B.js";
+import {
+  preview
+} from "./chunk-PFVLROGP.js";
 export {
-  dev
+  build,
+  dev,
+  preview
 };

package/dist/main.d.ts

@@ -1,2 +1 @@
-
-export {  }
+#!/usr/bin/env node

package/dist/main.js

@@ -1,6 +1,13 @@
+#!/usr/bin/env node
+import {
+  objectify
+} from "./chunk-SPF3AMMV.js";
+
 // src/main.ts
 import {
+  array,
   command,
+  multioption,
   option,
   optional,
   positional,
@@ -8,6 +15,20 @@ import {
   string,
   subcommands
 } from "cmd-ts";
+
+// src/common/parseDefines.ts
+function parseDefines(define) {
+  if (!define) {
+    return void 0;
+  }
+  return objectify(
+    define.map((d) => d.split(":")),
+    ([key]) => key,
+    ([, value]) => value ? isNaN(parseFloat(value)) ? JSON.stringify(value) : value : ""
+  );
+}
+
+// src/main.ts
 var dev = command({
   name: "dev",
   description: "Start the development server",
@@ -22,32 +43,74 @@ var dev = command({
       long: "port",
       short: "p",
       description: "The port to use for the development server"
+    }),
+    define: multioption({
+      type: optional(array(string)),
+      long: "define",
+      short: "d",
+      description: "Statically replace specific variables in the source code"
     })
   },
-  async handler({ root, port }) {
+  async handler({ root, port, define }) {
     const { dev: dev2 } = await import("./tools/dev.js");
-    await dev2(root, { port });
+    await dev2(root, {
+      port,
+      define: parseDefines(define)
+    });
   }
 });
 var build = command({
   name: "build",
-  description: "Generate a bundle for each function",
+  description: "Bundle your functions for deployment",
   args: {
     root: positional({
       type: optional(string),
       displayName: "root",
       description: "Directory to search for function entrypoints"
+    }),
+    outdir: option({
+      type: optional(string),
+      long: "outdir",
+      short: "o",
+      description: "The directory to write bundled output to"
+    }),
+    define: multioption({
+      type: optional(array(string)),
+      long: "define",
+      short: "d",
+      description: "Statically replace specific variables in the source code"
+    })
+  },
+  async handler({ root, outdir, define }) {
+    const { build: build2 } = await import("./tools/build.js");
+    await build2(root, {
+      outdir,
+      define: parseDefines(define)
+    });
+  }
+});
+var preview = command({
+  name: "preview",
+  description: "Preview bundled functions locally",
+  args: {
+    outDir: option({
+      type: optional(string),
+      long: "outDir",
+      short: "o",
+      description: "The directory containing the bundled output"
     })
   },
-  async handler() {
-    throw new Error("Not implemented");
+  async handler({ outDir }) {
+    const { preview: preview2 } = await import("./tools/preview.js");
+    await preview2({ outDir });
   }
 });
 var cli = subcommands({
   name: "cloud-run-functions",
   cmds: {
     dev,
-    build
+    build,
+    preview
   }
 });
 await run(cli, process.argv.slice(2));

package/dist/targets/build.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/targets/build.js

@@ -0,0 +1,53 @@
+// src/targets/build.ts
+import "source-map-support/register.js";
+import functions from "@google-cloud/functions-framework";
+import { adapter, routes } from "virtual:cloud-run-functions";
+var routesByPath = new Map(routes.map((route) => [route.path, route]));
+var handlerCache = /* @__PURE__ */ new Map();
+function unwrapHandler(module) {
+  let handler = module;
+  while (handler && typeof handler !== "function") {
+    handler = handler.default;
+  }
+  return typeof handler === "function" ? handler : null;
+}
+async function getHandler(route) {
+  const cached = handlerCache.get(route.path);
+  if (cached) {
+    return cached;
+  }
+  let handler = unwrapHandler(route.module);
+  if (!handler) {
+    throw new Error(`Task ${route.name} is not a function.`);
+  }
+  switch (adapter) {
+    case "hattip": {
+      const { createMiddleware } = await import("@hattip/adapter-node");
+      handler = createMiddleware(handler);
+      break;
+    }
+  }
+  handlerCache.set(route.path, handler);
+  return handler;
+}
+async function match(url) {
+  const route = routesByPath.get(url.pathname);
+  if (!route) {
+    return null;
+  }
+  return getHandler(route);
+}
+functions.http("build", async (req, res) => {
+  const url = new URL(req.url, "http://" + req.headers.host);
+  const handler = await match(url);
+  if (handler) {
+    try {
+      await handler(req, res);
+    } catch (error) {
+      console.error(error);
+      res.status(500).end();
+    }
+  } else {
+    res.status(404).end();
+  }
+});

package/dist/targets/dev.js

@@ -1,3 +1,13 @@
+import {
+  getFunctionFilter,
+  loadConfig
+} from "../chunk-MOB3GBJW.js";
+import {
+  isNumber,
+  timeout,
+  toResult
+} from "../chunk-SPF3AMMV.js";
+
 // src/targets/dev.ts
 import "source-map-support/register.js";
 import functions from "@google-cloud/functions-framework";
@@ -6,73 +16,7 @@ import { findUpSync } from "find-up-simple";
 import fs2 from "node:fs";
 import { Module } from "node:module";
 import os from "node:os";
-import path3 from "node:path";
-
-// node_modules/.pnpm/radashi@12.4.0/node_modules/radashi/dist/radashi.js
-var TimeoutError = class extends Error {
-  constructor(message) {
-    super(message ?? "Operation timed out");
-    this.name = "TimeoutError";
-  }
-};
-function timeout(ms, error) {
-  return new Promise(
-    (_, reject) => setTimeout(
-      () => reject(isFunction(error) ? error() : new TimeoutError(error)),
-      ms
-    )
-  );
-}
-async function toResult(promise) {
-  try {
-    const result = await promise;
-    return [void 0, result];
-  } catch (error) {
-    if (isError(error)) {
-      return [error, void 0];
-    }
-    throw error;
-  }
-}
-function dedent(text, ...values) {
-  var _a;
-  if (isArray(text)) {
-    if (values.length > 0) {
-      return dedent(
-        text.reduce((acc, input, i) => {
-          var _a2;
-          let value = String(values[i] ?? "");
-          const indent2 = value.includes("\n") && ((_a2 = input.match(/[ \t]*(?=[^\n]*$)/)) == null ? void 0 : _a2[0]);
-          if (indent2) {
-            value = value.replace(/\n(?=[^\n]*?\S)/g, "\n" + indent2);
-          }
-          return acc + input + value;
-        }, "")
-      );
-    }
-    text = text[0];
-  }
-  const indent = values[0] ?? ((_a = text.match(/^[ \t]*(?=\S)/m)) == null ? void 0 : _a[0]);
-  const output = indent ? text.replace(new RegExp(`^${indent}`, "gm"), "") : text;
-  return output.replace(/^[ \t]*\n|\n[ \t]*$/g, "");
-}
-var isArray = /* @__PURE__ */ (() => Array.isArray)();
-var asyncIteratorSymbol = (
-  /* c8 ignore next */
-  Symbol.asyncIterator || Symbol.for("Symbol.asyncIterator")
-);
-function isError(value) {
-  return isTagged(value, "[object Error]");
-}
-function isFunction(value) {
-  return typeof value === "function";
-}
-function isNumber(value) {
-  return typeof value === "number" && !Number.isNaN(value);
-}
-function isTagged(value, tag) {
-  return Object.prototype.toString.call(value) === tag;
-}
+import path from "node:path";
 
 // src/common/emptyDir.ts
 import fs from "node:fs";
@@ -82,122 +26,21 @@ function emptyDir(dir) {
   return dir;
 }
 
-// src/common/functionFilter.ts
-import path from "node:path";
-function getFunctionFilter(options) {
-  const functionGlobs = [];
-  const functionSuffixes = /* @__PURE__ */ new Set();
-  const requiredSuffix = options.entrySuffix?.replace(/^\.?/, ".") ?? "";
-  for (const glob of options.globs ?? ["**/*"]) {
-    let ext = path.extname(glob);
-    if (ext) {
-      functionSuffixes.add(requiredSuffix + ext);
-      functionGlobs.push(
-        requiredSuffix ? glob.replace(ext, requiredSuffix + ext) : glob
-      );
-      continue;
-    }
-    for (ext of options.extensions ?? [".ts", ".js"]) {
-      ext = requiredSuffix + ext;
-      functionSuffixes.add(ext);
-      functionGlobs.push(glob + ext);
-    }
-  }
-  const suffixPattern = new RegExp(
-    `(${Array.from(functionSuffixes, (e) => e.replace(/\./g, "\\.")).sort((a, b) => b.length - a.length).join("|")})$`
-  );
-  return {
-    globs: functionGlobs,
-    suffixPattern
-  };
-}
-
 // src/common/hash.ts
 import crypto from "node:crypto";
 function hash(data, len) {
   return crypto.createHash("sha256").update(data).digest("hex").slice(0, len);
 }
 
-// src/config/index.ts
-import * as z2 from "@zod/mini";
-import Joycon from "joycon";
-import path2 from "node:path";
-
-// src/config/schema.ts
-import * as z from "@zod/mini";
-var configSchema = z.partial(
-  z.interface({
-    root: z.string().register(z.globalRegistry, {
-      description: dedent`
-        The base directory when searching for entry points.
-
-        Defaults to the config directory (or if no config file is found, the current working directory).
-      `
-    }),
-    globs: z.array(z.string()).register(z.globalRegistry, {
-      description: dedent`
-        The globs determine which directories are searched for entry points. Only ".ts" and ".js" files are matched, so you're not required to include them in the globs.
-
-        By default all directories in the "root" are searched.
-      `
-    }),
-    extensions: z.array(z.string()).register(z.globalRegistry, {
-      description: dedent`
-        The extensions to match for entry points.
-
-        @default [".ts", ".js"]
-      `
-    }),
-    entrySuffix: z.string().register(z.globalRegistry, {
-      description: dedent`
-        The entry suffix should be a string like ".task" or ".function" which must be present in the file name (before the extension) or else that file will be ignored when scanning for entry points.
-
-        It can also be an empty string.
-      `
-    }),
-    adapter: z.enum(["hattip", "node"]).register(z.globalRegistry, {
-      description: dedent`
-        The adapter wraps your Cloud Run functions at runtime, allowing you to write them with a platform-agnostic HTTP framework, like Hattip.
-
-        Set this to "node" to skip using an adapter, in which case, your functions should conform to what @google-cloud/functions-framework expects.
-
-        @default "node"
-      `
-    }),
-    maxInstanceConcurrency: z.union([z.number(), z.record(z.string(), z.number())]).register(z.globalRegistry, {
-      description: dedent`
-          The maximum number of instances (per function) that can be run concurrently. You can either set the same limit for all functions or set a different limit for each function.
-
-          @default 5
-        `
-    })
-  })
-);
-
-// src/config/index.ts
-var joycon = new Joycon();
-function loadConfig(cwd) {
-  const result = joycon.loadSync(["crf.config.json"], cwd);
-  if (!result.path) {
-    return {
-      configDir: null
-    };
-  }
-  return {
-    ...z2.parse(configSchema, result.data),
-    configDir: path2.dirname(result.path)
-  };
-}
-
 // src/targets/dev.ts
 async function createBuild() {
   const options = JSON.parse(process.env.CRF_OPTIONS);
-  const searchDir = path3.resolve(options.workingDir, options.searchDir ?? "");
+  const searchDir = path.resolve(options.workingDir, options.searchDir ?? "");
   const config = loadConfig(searchDir);
-  const root = config.configDir ? path3.resolve(config.configDir, config.root ?? "") : searchDir;
+  const root = config.configDir ? path.resolve(config.configDir, config.root ?? "") : searchDir;
   const functionFilter = getFunctionFilter(config);
   const cacheDir = emptyDir(
-    path3.join(
+    path.join(
       fs2.realpathSync(os.tmpdir()),
       "cloud-run-functions-" + hash(root, 8)
     )
@@ -223,14 +66,26 @@ async function createBuild() {
       {
         name: "build-status",
         setup(build) {
+          let startTime;
           pendingBuild = Promise.withResolvers();
           build.onStart(() => {
             pendingBuild ??= Promise.withResolvers();
+            startTime = Date.now();
           });
           build.onEnd((result) => {
             if (pendingBuild) {
               pendingBuild.resolve(result);
               pendingBuild = void 0;
+              console.log(
+                `[%s] %s your Cloud Run functions in %sms.`,
+                (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", {
+                  hour: "2-digit",
+                  minute: "2-digit",
+                  hour12: false
+                }),
+                finishedBuild ? "Rebuilt" : "Built",
+                Date.now() - startTime
+              );
             }
             finishedBuild = result;
           });
@@ -287,7 +142,7 @@ async function createBuild() {
           taskState.running++;
           taskStates.set(taskName, taskState);
           const require2 = Module.createRequire(import.meta.filename);
-          let taskHandler = require2(path3.join(root, file));
+          let taskHandler = require2(path.join(root, file));
           while (taskHandler && typeof taskHandler !== "function") {
             taskHandler = taskHandler.default;
           }

package/dist/tools/build.d.ts

@@ -1,3 +1,5 @@
+import esbuild from 'esbuild';
+
 type BuildOptions = {
     /**
      * Statically replace specific variables in the source code.
@@ -13,5 +15,32 @@ type BuildOptions = {
      */
     define?: Record<string, string>;
 };
+type BundleOptions = BuildOptions & {
+    /**
+     * The directory to write the bundled output to.
+     * @default "dist"
+     */
+    outdir?: string;
+};
+declare function build(root?: string, { define, outdir }?: BundleOptions): Promise<esbuild.BuildResult<{
+    entryPoints: string[];
+    absWorkingDir: string;
+    outfile: string;
+    define: Record<string, string> | undefined;
+    bundle: true;
+    format: "cjs";
+    platform: "node";
+    packages: "bundle";
+    sourcemap: true;
+    sourcesContent: false;
+    logOverride: {
+        'empty-glob': "silent";
+    };
+    plugins: {
+        name: string;
+        setup(build: esbuild.PluginBuild): void;
+    }[];
+    external: string[];
+}>>;
 
-export type { BuildOptions };
+export { type BuildOptions, type BundleOptions, build };

package/dist/tools/build.js

@@ -0,0 +1,8 @@
+import {
+  build
+} from "../chunk-NINUPPZA.js";
+import "../chunk-MOB3GBJW.js";
+import "../chunk-SPF3AMMV.js";
+export {
+  build
+};

package/dist/tools/dev.d.ts

@@ -1,6 +1,7 @@
 import * as picospawn from 'picospawn';
 import { PicospawnOptions } from 'picospawn';
 import { BuildOptions } from './build.js';
+import 'esbuild';
 
 interface DevOptions extends PicospawnOptions, BuildOptions {
     /**

package/dist/tools/preview.d.ts

@@ -0,0 +1,16 @@
+import * as picospawn from 'picospawn';
+import { PicospawnOptions } from 'picospawn';
+
+interface PreviewOptions extends PicospawnOptions {
+    /**
+     * The directory containing the bundled output.
+     * @default "dist"
+     */
+    outDir?: string;
+}
+/**
+ * Start the preview server for the bundled output.
+ */
+declare function preview({ outDir, ...options }?: PreviewOptions): picospawn.PicospawnPromise<unknown>;
+
+export { type PreviewOptions, preview };

package/dist/tools/preview.js

@@ -0,0 +1,6 @@
+import {
+  preview
+} from "../chunk-PFVLROGP.js";
+export {
+  preview
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cloud-run-functions",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "bin": "./dist/main.js",
   "exports": {
     "types": "./dist/index.d.ts",