@supacloud/compiler 0.51.2 → 0.52.0

package/DELIVERY.md

@@ -62,25 +62,48 @@ their kind. HTTP and Job ownership are independent, so one module can contribute
 HTTP to `api` and Jobs to `jobs`. Two HTTP targets cannot both own the same module.
 `api` and `jobs` are reserved for their matching workload kinds.
 
-`kind: "function"` declares an Edge Function target instead of an app-module
-target. It carries a `function` descriptor (`slug`, `entrypoint`, `verifyJwt`)
-and must not declare `modules`. Function targets own no HTTP routes or Jobs, so
-the plan surfaces them alongside the module-owned targets:
+`kind: "function"` declares an Edge Function target. It always carries a
+`function` descriptor (`slug`, `entrypoint`, `verifyJwt`). A Function target may
+be standalone or own modules:
+
+- **Standalone** (`modules` omitted): the entrypoint is the Function handler
+  itself. It may export a default function/object or named `fetch`/`handle`.
+- **Module-backed** (for example `modules: ["reports"]`): the entrypoint is a
+  trusted host composition module exporting
+  `createDeliveryApplication(modules, lifecycle)`, the same contract used by an
+  HTTP host. The selected modules' HTTP routes move to the Function target; their
+  Jobs do not. This is the supported way to split a heavy module out of `api`
+  without writing a second application by hand.
 
 ```ts
 {
   version: 1,
   targets: [
+    { name: "reports", kind: "function", modules: ["reports"],
+      function: { slug: "app-reports", entrypoint: "functions/reports-host.ts", verifyJwt: true } },
     { name: "intake-hooks", kind: "function",
-      function: { slug: "fa-intake-hooks", entrypoint: "functions/intake/index.ts", verifyJwt: false } },
+      function: { slug: "app-intake-hooks", entrypoint: "functions/intake/index.ts", verifyJwt: false } },
   ],
 }
 ```
 
-This version only **plans** function targets. The local delivery build still
-rejects them with `delivery-function-build-unsupported`; rendering, upload and
-activation belong to a later delivery phase (see the project deployment
-Function/schedule work). Existing HTTP/Worker configuration is unaffected.
+For a module/feature declaration, the `functions` shorthand expands to the same
+validated Function target. The target name defaults to the slug:
+
+```ts
+{
+  version: 1,
+  functions: [
+    { slug: "app-reports", modules: ["reports"],
+      entrypoint: "functions/reports-host.ts", verifyJwt: true },
+  ],
+}
+```
+
+Expansion is deterministic and happens before route ownership. Duplicate target
+names, duplicate Function slugs, and modules owned by two HTTP/Function targets
+fail closed. The shorthand does not guess entrypoints or permissions. `api` and
+`jobs` remain reserved for their matching workload kinds.
 
 No unused explicit target is accepted. Unknown modules, duplicate ownership,
 unresolved imports, cyclic dependencies, duplicate job names, and conflicting
@@ -152,7 +175,8 @@ delivery/
     generated/application.ts
     bundle/index.js
     bundle/package.json
-    bundle/app.manifest.json
+    bundle/app.manifest.json      # module-backed targets
+    bundle/function.json          # Function targets only
     bundle/target.json
     bundle/assets/...
 ```
@@ -287,8 +311,10 @@ HOST=127.0.0.1 PORT=3000 bun --no-env-file bundle/index.js
 ```
 
 HTTP objects have `entryKind: "bun-http-application"`; their entry is an executable
-that starts the listener, not an import-only module factory. Targets without a
-host keep `entryKind: "compiled-module-factory"`. All object kinds still report
+that starts the listener, not an import-only module factory. Function targets
+produce `entryKind: "bun-function-application"` entries exporting a default
+`fetch` handler. Targets without a host keep
+`entryKind: "compiled-module-factory"`. All object kinds still report
 `deploymentReady: false`: a local build neither activates a service nor verifies
 its environment, migrations, health, credentials, isolation or recovery.
 HTTP object identities bind their executable discriminator; existing factory
@@ -310,6 +336,31 @@ and host cleanup; expiry exits nonzero without claiming cleanup succeeded.
 Startup, listener and shutdown failures use generic messages; the host remains
 responsible for sanitizing its own logging and responses.
 
+## Runnable Functions
+
+Module-backed Function targets use the same host contract as HTTP targets:
+export `createDeliveryApplication(modules, lifecycle)` from the declared
+entrypoint. The generated bundle exports a default `{ fetch(request) }` object.
+The host is created lazily once per Function isolate and the host owns its
+identity, database, governance, and error policy. The compiler does not provide
+an anonymous or in-memory fallback.
+
+Standalone Function targets do not require a compiler application graph. Their
+declared entrypoint is imported and its default export (or the module namespace
+when there is no default) becomes the Function handler. Use this for an existing
+fetch handler that has no module-owned HTTP routes.
+
+Function bundles include `bundle/function.json` with the attested slug,
+entrypoint, and `verifyJwt` declaration. Module-backed Functions also include
+the normal application manifest, execution context, and development metadata;
+standalone Functions do not. Function objects carry
+`entryKind: "bun-function-application"` in their immutable identity.
+
+This stage builds local Function artifacts only. Application release upload still
+rejects a delivery manifest containing Function targets, so they cannot be
+silently started as application HTTP services. Creating the Edge Function
+version, activation, and receipt remains a separate trusted release operation.
+
 ## Runnable Workers
 
 Job targets can explicitly bind a worker host:

package/README.md

@@ -594,6 +594,42 @@ parameters、requestBody、responses、securitySchemes 以及 `x-supacloud` 路
 因此不会维护第二份 API contract。默认包含 bearer JWT scheme；项目可在
 `openApi` 配置中补充文档信息、servers 和其他显式 security schemes。
 
+内存受限的业务进程可配置 `openApi: { snapshots: false }`，只生成
+`createOpenApiDocument` 和 `serializeOpenApiDocument` 工厂，不导出
+`OPENAPI_DOCUMENT` / `OPENAPI_JSON`，也不在模块加载时转换完整文档或序列化 JSON。
+例如：
+
+```ts
+export default defineSupacloudConfig({
+  generateOpenApi: true,
+  openApi: { title: "Orders API", version: "1.0.0", snapshots: false },
+});
+```
+
+重新生成后，可将工厂传给可选文档插件，按请求创建文档：
+
+```ts
+import { createOpenApiDocument } from "./generated/openapi";
+
+const documentation = {
+  openApi: { document: createOpenApiDocument },
+};
+// createApplication({ ..., documentation })
+```
+
+该模式仍加载文档所引用的 schema 和路由定义，但不会缓存生成的文档对象或 JSON
+字符串。`serializeOpenApiDocument()` 每次调用都会创建并序列化一份新文档；传入
+显式 document 时直接序列化该对象。应用路由的响应校验不受影响。
+
+需要彻底移出业务进程时，在构建/发布阶段使用下方 `openapi-export` 导出静态
+`openapi.json`，由静态服务或独立文档入口提供，业务入口不再导入生成的 OpenAPI
+模块。GraphQL SDL 同样可直接发布已有 `schema.graphql` 文件；生成的 GraphQL
+查询和结果校验应继续保留。部署必须显式携带这些静态文件，单文件函数 bundle
+不能假设请求时可访问源码目录。
+
+`snapshots` 默认仍为 `true`，保持旧导出兼容。快照初始化带有 pure 注解，支持该
+注解的打包器可移除未使用的快照；未打包导入默认模块仍会创建两份快照。
+
 `OPENAPI_JSON` 是运行时快照；需要提交独立 `openapi.json` 时，在应用已经能加载
 生成模块的运行时调用 `exportGeneratedOpenApiJson()` 或直接写出该字符串。编译器
 不会为了生成 JSON 执行应用 schema。`readOpenApiJson()` 和
@@ -625,7 +661,8 @@ supacloud-compiler openapi-export ./generated/openapi.ts ./generated/openapi.jso
 supacloud-compiler openapi-diff ./contracts/openapi.base.json ./generated/openapi.json --json
 ```
 
-`openapi-export` 在运行时加载生成的 `openapi.ts` 并原子地写出独立 JSON；它不会在
+`openapi-export` 在运行时加载生成的 `openapi.ts` 并原子地写出独立 JSON；也支持
+`snapshots: false` 的模块，此时调用 `createOpenApiDocument()`。它不会在
 编译阶段执行应用 schema。可用 `--space 0` 到 `--space 10` 控制缩进，重复执行不会
 改写内容不变的文件。当前只承诺 JSON 输出，YAML 转换由发布流水线按需处理。
 

package/dist/cli.js

@@ -3438,6 +3438,7 @@ ${procedureMethods.join(`
 function renderOpenApi(graph, options) {
   const rootDir = options?.rootDir ?? process.cwd();
   const outDir = options?.outDir ?? process.cwd();
+  const snapshots = options?.openApi?.snapshots !== false;
   const imports = new ImportManager;
   const schemaLocals = new Map;
   const schemaComponents = new Map;
@@ -3933,14 +3934,18 @@ function renderOpenApi(graph, options) {
     "  };",
     "}",
     "",
-    "export const OPENAPI_DOCUMENT = createOpenApiDocument();",
-    "",
-    "export function serializeOpenApiDocument(document: OpenApiDocument = OPENAPI_DOCUMENT, space = 2): string {",
+    ...snapshots ? [
+      "export const OPENAPI_DOCUMENT = /* @__PURE__ */ createOpenApiDocument();",
+      ""
+    ] : [],
+    `export function serializeOpenApiDocument(document: OpenApiDocument = ${snapshots ? "OPENAPI_DOCUMENT" : "createOpenApiDocument()"}, space = 2): string {`,
     '  return JSON.stringify(document, null, space) + "\\n";',
     "}",
     "",
-    "export const OPENAPI_JSON = serializeOpenApiDocument();",
-    ""
+    ...snapshots ? [
+      "export const OPENAPI_JSON = /* @__PURE__ */ serializeOpenApiDocument();",
+      ""
+    ] : []
   ].join(`
 `);
 }
@@ -16260,10 +16265,27 @@ function parseDeliveryOptions(value) {
     throw new DeliveryConfigurationError;
   }
   for (const target of value.targets ?? []) {
-    const invalidShape = target.kind === "function" ? target.function === undefined || target.modules !== undefined || target.compute !== undefined : target.modules === undefined || target.function !== undefined;
+    const invalidShape = target.kind === "function" ? target.function === undefined || target.compute !== undefined : target.modules === undefined || target.function !== undefined;
     if (invalidShape)
       throw new DeliveryConfigurationError;
   }
+  const targetNames = new Set((value.targets ?? []).map((target) => target.name));
+  const functionSlugs = new Set;
+  for (const target of value.targets ?? []) {
+    if (target.function !== undefined && functionSlugs.has(target.function.slug)) {
+      throw new DeliveryConfigurationError;
+    }
+    if (target.function !== undefined)
+      functionSlugs.add(target.function.slug);
+  }
+  for (const declared of value.functions ?? []) {
+    const name = declared.name ?? declared.slug;
+    if (targetNames.has(name) || functionSlugs.has(declared.slug)) {
+      throw new DeliveryConfigurationError;
+    }
+    targetNames.add(name);
+    functionSlugs.add(declared.slug);
+  }
   const migrations = value.build?.migrations ?? [];
   try {
     validateWorkerExecution(value.execution?.groups ?? []);
@@ -16273,14 +16295,30 @@ function parseDeliveryOptions(value) {
   if (new Set(migrations.map((item) => item.version)).size !== migrations.length || new Set(migrations.map((item) => item.source)).size !== migrations.length || migrations.some((item) => BigInt(item.version) > 9223372036854775807n || !/\.sql$/i.test(item.source) || item.source.split("/").includes("node_modules"))) {
     throw new DeliveryConfigurationError;
   }
-  return value;
+  if (value.functions === undefined || value.functions.length === 0)
+    return value;
+  const targets = [...value.targets ?? []];
+  for (const declared of value.functions) {
+    targets.push({
+      name: declared.name ?? declared.slug,
+      kind: "function",
+      modules: [...declared.modules],
+      function: {
+        slug: declared.slug,
+        entrypoint: declared.entrypoint,
+        verifyJwt: declared.verifyJwt
+      }
+    });
+  }
+  const { functions: _expandedFunctions, ...rest } = value;
+  return { ...rest, targets };
 }
 function parseDeliveryPlanResult(value) {
   if (!Check2(DeliveryPlanResultSchema, value))
     throw new Error("Invalid delivery plan result.");
   return value;
 }
-var objectOptions, reference2, references, kind2, isolation, mode2, DeliveryFilePathSchema, functionTarget, DeliveryOptionsSchema, DeliveryDiagnosticSchema, routeSchema, jobSchema, DeliveryTargetSchema, DeliveryPlanSchema, DeliveryPlanResultSchema, DeliveryConfigurationError;
+var objectOptions, reference2, references, kind2, isolation, targetName, functionSlug, mode2, DeliveryFilePathSchema, functionTarget, automaticFunction, DeliveryOptionsSchema, DeliveryDiagnosticSchema, routeSchema, jobSchema, DeliveryTargetSchema, DeliveryPlanSchema, DeliveryPlanResultSchema, DeliveryConfigurationError;
 var init_delivery_schema = __esm(() => {
   init_build();
   init_value2();
@@ -16290,13 +16328,22 @@ var init_delivery_schema = __esm(() => {
   references = _Array_(reference2, { uniqueItems: true });
   kind2 = Union([Literal("api"), Literal("jobs"), Literal("webhook"), Literal("function")]);
   isolation = Union([Literal("shared"), Literal("process")]);
+  targetName = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
+  functionSlug = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
   mode2 = Union([Literal("required"), Literal("none")]);
   DeliveryFilePathSchema = String2({
     maxLength: 512,
     pattern: "^(?:[A-Za-z0-9_-][A-Za-z0-9_.-]*/)*[A-Za-z0-9_-][A-Za-z0-9_.-]*$"
   });
   functionTarget = _Object_({
-    slug: String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" }),
+    slug: functionSlug,
+    entrypoint: DeliveryFilePathSchema,
+    verifyJwt: Boolean2()
+  }, objectOptions);
+  automaticFunction = _Object_({
+    name: Optional(targetName),
+    slug: functionSlug,
+    modules: _Array_(reference2, { minItems: 1, uniqueItems: true }),
     entrypoint: DeliveryFilePathSchema,
     verifyJwt: Boolean2()
   }, objectOptions);
@@ -16304,7 +16351,7 @@ var init_delivery_schema = __esm(() => {
     version: Literal(1),
     execution: Optional(WorkerExecutionSchema),
     targets: Optional(_Array_(_Object_({
-      name: String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" }),
+      name: targetName,
       kind: kind2,
       modules: Optional(_Array_(reference2, { minItems: 1, uniqueItems: true })),
       isolation: Optional(isolation),
@@ -16312,6 +16359,7 @@ var init_delivery_schema = __esm(() => {
       compute: Optional(ComputeResourcesSchema),
       function: Optional(functionTarget)
     }, objectOptions))),
+    functions: Optional(_Array_(automaticFunction, { maxItems: 32 })),
     runtime: Optional(_Object_({
       processIsolation: Boolean2(),
       durableQueue: Boolean2(),
@@ -16616,7 +16664,7 @@ function parseDeliveryBuildManifest(value) {
   }
   for (const object of value.objects) {
     const target = value.plan.targets.find((target) => target.name === object.name);
-    if (["bun-worker-application", "go-worker-application", "scriptc-worker-application"].includes(object.entryKind) && target?.kind !== "jobs" || object.entryKind === "bun-http-application" && target?.kind === "jobs") {
+    if (["bun-worker-application", "go-worker-application", "scriptc-worker-application"].includes(object.entryKind) && target?.kind !== "jobs" || object.entryKind === "bun-http-application" && target?.kind === "jobs" || object.entryKind === "bun-function-application" && target?.kind !== "function" || target?.kind === "function" && object.entryKind !== "bun-function-application") {
       throw new Error("Delivery executable kind does not match its target.");
     }
     if (new Set(object.files.map((file) => file.path)).size !== object.files.length || !object.files.some((file) => file.path === object.entrypoint) || deliveryObjectDigest(object) !== object.objectId) {
@@ -16660,6 +16708,7 @@ var init_delivery_build_schema = __esm(() => {
       Literal("compiled-module-factory"),
       Literal("bun-http-application"),
       Literal("bun-worker-application"),
+      Literal("bun-function-application"),
       Literal("go-worker-application"),
       Literal("scriptc-worker-application")
     ]),
@@ -17104,7 +17153,7 @@ var init_application_release = __esm(() => {
 });
 
 // node_modules/@supacloud/delivery/src/application-configuration.ts
-var ApplicationConfigurationIdSchema, targetName, variableName2, kind3, hosts, bunVersion, ApplicationConfigurationSchema, ApplicationConfigurationWriteSchema, ApplicationConfigurationViewSchema, APPLICATION_RESERVED_ENVIRONMENT_NAMES;
+var ApplicationConfigurationIdSchema, targetName2, variableName2, kind3, hosts, bunVersion, ApplicationConfigurationSchema, ApplicationConfigurationWriteSchema, ApplicationConfigurationViewSchema, APPLICATION_RESERVED_ENVIRONMENT_NAMES;
 var init_application_configuration = __esm(() => {
   init_build();
   init_value2();
@@ -17112,7 +17161,7 @@ var init_application_configuration = __esm(() => {
   ApplicationConfigurationIdSchema = String2({
     pattern: "^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$"
   });
-  targetName = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
+  targetName2 = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
   variableName2 = String2({ pattern: "^[A-Z][A-Z0-9_]{0,127}$" });
   kind3 = Union([Literal("http"), Literal("worker")]);
   hosts = _Array_(String2({ minLength: 1, maxLength: 253 }), { maxItems: 32, uniqueItems: true });
@@ -17120,7 +17169,7 @@ var init_application_configuration = __esm(() => {
   ApplicationConfigurationSchema = _Object_({
     bun_version: bunVersion,
     targets: _Array_(_Object_({
-      name: targetName,
+      name: targetName2,
       kind: kind3,
       hosts,
       environment: Record(variableName2, String2({ maxLength: 16384 }), {
@@ -17143,7 +17192,7 @@ var init_application_configuration = __esm(() => {
     created_at: String2(),
     bun_version: bunVersion,
     targets: _Array_(_Object_({
-      name: targetName,
+      name: targetName2,
       kind: kind3,
       hosts,
       environment_names: _Array_(variableName2, { maxItems: 128, uniqueItems: true })
@@ -23991,7 +24040,7 @@ function createDeliveryPlan(graph, input, validation) {
       name: declaration.name,
       kind: "function",
       isolation: "shared",
-      roots: [],
+      roots: sorted(declaration.modules ?? []),
       modules: [],
       routes: [],
       jobs: [],
@@ -24780,6 +24829,53 @@ interface DeliveryWorkerHost {
 `;
 }
 
+// src/delivery-function.ts
+function renderDeliveryFunctionEntry(generatedDirectory, hostPath) {
+  const specifier = relativeImportPath(generatedDirectory, hostPath);
+  return `
+import * as deliveryFunctionHostModule from ${JSON.stringify(specifier)};
+
+type DeliveryFunctionHost = {
+  fetch(request: Request): Response | Promise<Response>;
+};
+
+const createDeliveryFunctionHost = (deliveryFunctionHostModule as {
+  createDeliveryApplication?: (
+    modules: ReturnType<typeof createCompiledModules>,
+    lifecycle: { signal: AbortSignal },
+  ) => DeliveryFunctionHost | Promise<DeliveryFunctionHost>;
+}).createDeliveryApplication;
+if (typeof createDeliveryFunctionHost !== "function") {
+  throw new Error("Invalid delivery Function host.");
+}
+const deliveryCreateHost = createDeliveryFunctionHost;
+
+const deliveryFunctionLifecycle = new AbortController();
+let deliveryFunctionHost: Promise<DeliveryFunctionHost> | undefined;
+function deliveryHost(): Promise<DeliveryFunctionHost> {
+  return deliveryFunctionHost ??= Promise.resolve(
+    deliveryCreateHost(createCompiledModules(), { signal: deliveryFunctionLifecycle.signal }),
+  );
+}
+
+export default {
+  async fetch(request: Request): Promise<Response> {
+    return (await deliveryHost()).fetch(request);
+  },
+};
+`;
+}
+function renderStandaloneFunctionEntry(generatedDirectory, entrypointPath) {
+  const specifier = relativeImportPath(generatedDirectory, entrypointPath);
+  return `
+import * as deliveryFunctionEntry from ${JSON.stringify(specifier)};
+
+const deliveryFunctionDefault: unknown = (deliveryFunctionEntry as { default?: unknown }).default
+  ?? deliveryFunctionEntry;
+export default deliveryFunctionDefault;
+`;
+}
+
 // src/delivery-migrations.ts
 init_delivery_files2();
 import { resolve as resolve16 } from "node:path";
@@ -24875,14 +24971,6 @@ async function buildDeliveryProject(options, delivery) {
     const planned = createDeliveryPlan({ ...checked.graph, diagnostics: checked.diagnostics }, settings, options);
     if (!planned.ok)
       return failed(planned.diagnostics);
-    if (planned.plan.targets.some((target) => target.kind === "function")) {
-      return failed([{
-        severity: "error",
-        code: "delivery-function-build-unsupported",
-        message: "Function target rendering is not implemented yet; the delivery build only produces HTTP and Worker application objects.",
-        suggestion: "Declare HTTP/Worker application targets for now; Function and schedule delivery is tracked separately."
-      }]);
-    }
     if (options.graphql && checked.mismatches.some((mismatch) => mismatch.startsWith("graphql"))) {
       throw new Error("Refresh GraphQL artifacts with compile before building independent targets.");
     }
@@ -24912,6 +25000,17 @@ async function buildDeliveryProject(options, delivery) {
         hosts.set(app.target, { path, kind, hash: digest(await readOwned(sourceRoot, path)) });
       }
     }
+    for (const target of planned.plan.targets) {
+      if (target.kind !== "function" || target.modules.length === 0 || target.function === undefined)
+        continue;
+      if (hosts.has(target.name))
+        throw new Error("Duplicate delivery application host.");
+      const path = resolve17(sourceRoot, target.function.entrypoint);
+      if (inside(generatedRoot, path) || !/\.[cm]?ts$/.test(path)) {
+        throw new Error("Function hosts require application TypeScript source.");
+      }
+      hosts.set(target.name, { path, kind: "function", hash: digest(await readOwned(sourceRoot, path)) });
+    }
     phase = "migration-inputs";
     const migrations = await prepareDeliveryMigrations(project, generatedRoot, settings.build?.migrations);
     phase = "output-ownership";
@@ -24966,19 +25065,38 @@ async function buildDeliveryProject(options, delivery) {
       const stage = await mkdtemp(join10(objectRoot, ".build-"));
       temporary.push(stage);
       const generatedDirectory = join10(objectRoot, "0".repeat(64), "generated");
-      const rendered = renderDeliveryTarget(checked.graph, target, {
+      const host = hosts.get(target.name);
+      const standaloneFunction = target.kind === "function" && target.modules.length === 0;
+      const rendered = standaloneFunction ? undefined : renderDeliveryTarget(checked.graph, target, {
         ...options,
         rootDir: sourceRoot,
         outDir: generatedDirectory
       });
-      const host = hosts.get(target.name);
-      const entryKind = host?.kind === "http" ? "bun-http-application" : host?.kind === "worker" ? "bun-worker-application" : "compiled-module-factory";
-      const applicationCode = rendered.applicationCode + (host?.kind === "http" ? renderDeliveryHttpEntry(generatedDirectory, host.path) : host?.kind === "worker" ? renderDeliveryWorkerEntry(generatedDirectory, host.path) : "");
-      const generated = {
-        "application.ts": applicationCode,
-        ...rendered.clientCode === undefined ? {} : { "client.ts": rendered.clientCode },
-        ...rendered.permissionsCode === undefined ? {} : { "permissions.ts": rendered.permissionsCode }
-      };
+      let entryKind;
+      let applicationCode;
+      let generated;
+      if (standaloneFunction) {
+        if (target.function === undefined)
+          throw new Error("Function target requires an entrypoint descriptor.");
+        const entrypointPath = resolve17(sourceRoot, target.function.entrypoint);
+        if (inside(generatedRoot, entrypointPath) || !/\.[cm]?ts$/.test(entrypointPath)) {
+          throw new Error("Standalone Function entrypoints require application TypeScript source.");
+        }
+        entryKind = "bun-function-application";
+        applicationCode = renderStandaloneFunctionEntry(generatedDirectory, entrypointPath);
+        generated = { "function.ts": applicationCode };
+      } else {
+        if (target.kind === "function" && host?.kind !== "function") {
+          throw new Error("Module-backed Function targets require an entrypoint host.");
+        }
+        entryKind = target.kind === "function" ? "bun-function-application" : host?.kind === "http" ? "bun-http-application" : host?.kind === "worker" ? "bun-worker-application" : "compiled-module-factory";
+        applicationCode = rendered.applicationCode + (host?.kind === "http" ? renderDeliveryHttpEntry(generatedDirectory, host.path) : host?.kind === "worker" ? renderDeliveryWorkerEntry(generatedDirectory, host.path) : host?.kind === "function" ? renderDeliveryFunctionEntry(generatedDirectory, host.path) : "");
+        generated = {
+          "application.ts": applicationCode,
+          ...rendered.clientCode === undefined ? {} : { "client.ts": rendered.clientCode },
+          ...rendered.permissionsCode === undefined ? {} : { "permissions.ts": rendered.permissionsCode }
+        };
+      }
       const unsafe = scanGeneratedArtifacts(generated, true);
       if (unsafe.some((item) => item.severity === "error"))
         return failed(unsafe);
@@ -25021,9 +25139,14 @@ async function buildDeliveryProject(options, delivery) {
       for (const [path, bytes] of bundled.files)
         await writeArtifact(stage, path, bytes);
       await writeArtifact(stage, "bundle/package.json", canonical2({ type: "module", private: true }));
-      await writeArtifact(stage, "bundle/app.manifest.json", rendered.manifestJson);
-      await writeArtifact(stage, "bundle/execution-context.json", rendered.executionSnapshot);
-      await writeArtifact(stage, "bundle/application-development.json", rendered.applicationDevelopment);
+      if (target.kind === "function" && target.function !== undefined) {
+        await writeArtifact(stage, "bundle/function.json", canonical2(target.function));
+      }
+      if (rendered !== undefined) {
+        await writeArtifact(stage, "bundle/app.manifest.json", rendered.manifestJson);
+        await writeArtifact(stage, "bundle/execution-context.json", rendered.executionSnapshot);
+        await writeArtifact(stage, "bundle/application-development.json", rendered.applicationDevelopment);
+      }
       for (const [path, bytes] of migrations.files)
         await writeArtifact(stage, path, bytes);
       await writeArtifact(stage, "bundle/target.json", canonical2({
@@ -25157,7 +25280,7 @@ import { readFileSync as readFileSync4 } from "node:fs";
 import { resolve as resolve18 } from "node:path";
 
 // src/migration-app-version.ts
-var MIGRATION_APP_VERSION = "0.33.0";
+var MIGRATION_APP_VERSION = "0.34.0";
 
 // src/migration-elysia-version.ts
 var MIGRATION_ELYSIA_VERSION = "0.36.2";
@@ -26039,7 +26162,11 @@ async function loadGeneratedOpenApiDocument(modulePath) {
     const loaded = await import(moduleUrl.href);
     if (!isRecord(loaded))
       throw new OpenApiDocumentError;
-    return parseOpenApiDocument(loaded["OPENAPI_DOCUMENT"]);
+    if ("OPENAPI_DOCUMENT" in loaded)
+      return parseOpenApiDocument(loaded["OPENAPI_DOCUMENT"]);
+    if (typeof loaded["createOpenApiDocument"] !== "function")
+      throw new OpenApiDocumentError;
+    return parseOpenApiDocument(await loaded["createOpenApiDocument"]());
   } catch (error) {
     if (error instanceof OpenApiDocumentError)
       throw error;

package/dist/delivery-bundle-protocol.d.ts

@@ -57,6 +57,13 @@ declare const requestSchema: Type.TObject<{
                 verifyJwt: Type.TBoolean;
             }>>;
         }>>>;
+        functions: Type.TOptional<Type.TArray<Type.TObject<{
+            name: Type.TOptional<Type.TString>;
+            slug: Type.TString;
+            modules: Type.TArray<Type.TString>;
+            entrypoint: Type.TString;
+            verifyJwt: Type.TBoolean;
+        }>>>;
         runtime: Type.TOptional<Type.TObject<{
             processIsolation: Type.TBoolean;
             durableQueue: Type.TBoolean;

package/dist/delivery-bundle-worker.js

@@ -10129,10 +10129,27 @@ function parseDeliveryOptions(value) {
     throw new DeliveryConfigurationError;
   }
   for (const target of value.targets ?? []) {
-    const invalidShape = target.kind === "function" ? target.function === undefined || target.modules !== undefined || target.compute !== undefined : target.modules === undefined || target.function !== undefined;
+    const invalidShape = target.kind === "function" ? target.function === undefined || target.compute !== undefined : target.modules === undefined || target.function !== undefined;
     if (invalidShape)
       throw new DeliveryConfigurationError;
   }
+  const targetNames = new Set((value.targets ?? []).map((target) => target.name));
+  const functionSlugs = new Set;
+  for (const target of value.targets ?? []) {
+    if (target.function !== undefined && functionSlugs.has(target.function.slug)) {
+      throw new DeliveryConfigurationError;
+    }
+    if (target.function !== undefined)
+      functionSlugs.add(target.function.slug);
+  }
+  for (const declared of value.functions ?? []) {
+    const name = declared.name ?? declared.slug;
+    if (targetNames.has(name) || functionSlugs.has(declared.slug)) {
+      throw new DeliveryConfigurationError;
+    }
+    targetNames.add(name);
+    functionSlugs.add(declared.slug);
+  }
   const migrations = value.build?.migrations ?? [];
   try {
     validateWorkerExecution(value.execution?.groups ?? []);
@@ -10142,14 +10159,30 @@ function parseDeliveryOptions(value) {
   if (new Set(migrations.map((item) => item.version)).size !== migrations.length || new Set(migrations.map((item) => item.source)).size !== migrations.length || migrations.some((item) => BigInt(item.version) > 9223372036854775807n || !/\.sql$/i.test(item.source) || item.source.split("/").includes("node_modules"))) {
     throw new DeliveryConfigurationError;
   }
-  return value;
+  if (value.functions === undefined || value.functions.length === 0)
+    return value;
+  const targets = [...value.targets ?? []];
+  for (const declared of value.functions) {
+    targets.push({
+      name: declared.name ?? declared.slug,
+      kind: "function",
+      modules: [...declared.modules],
+      function: {
+        slug: declared.slug,
+        entrypoint: declared.entrypoint,
+        verifyJwt: declared.verifyJwt
+      }
+    });
+  }
+  const { functions: _expandedFunctions, ...rest } = value;
+  return { ...rest, targets };
 }
 function parseDeliveryPlanResult(value) {
   if (!Check2(DeliveryPlanResultSchema, value))
     throw new Error("Invalid delivery plan result.");
   return value;
 }
-var objectOptions, reference, references, kind, isolation, mode, DeliveryFilePathSchema, functionTarget, DeliveryOptionsSchema, DeliveryDiagnosticSchema, routeSchema, jobSchema, DeliveryTargetSchema, DeliveryPlanSchema, DeliveryPlanResultSchema, DeliveryConfigurationError;
+var objectOptions, reference, references, kind, isolation, targetName, functionSlug, mode, DeliveryFilePathSchema, functionTarget, automaticFunction, DeliveryOptionsSchema, DeliveryDiagnosticSchema, routeSchema, jobSchema, DeliveryTargetSchema, DeliveryPlanSchema, DeliveryPlanResultSchema, DeliveryConfigurationError;
 var init_delivery_schema = __esm(() => {
   init_build2();
   init_value2();
@@ -10159,13 +10192,22 @@ var init_delivery_schema = __esm(() => {
   references = _Array_(reference, { uniqueItems: true });
   kind = Union([Literal("api"), Literal("jobs"), Literal("webhook"), Literal("function")]);
   isolation = Union([Literal("shared"), Literal("process")]);
+  targetName = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
+  functionSlug = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
   mode = Union([Literal("required"), Literal("none")]);
   DeliveryFilePathSchema = String2({
     maxLength: 512,
     pattern: "^(?:[A-Za-z0-9_-][A-Za-z0-9_.-]*/)*[A-Za-z0-9_-][A-Za-z0-9_.-]*$"
   });
   functionTarget = _Object_({
-    slug: String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" }),
+    slug: functionSlug,
+    entrypoint: DeliveryFilePathSchema,
+    verifyJwt: Boolean2()
+  }, objectOptions);
+  automaticFunction = _Object_({
+    name: Optional(targetName),
+    slug: functionSlug,
+    modules: _Array_(reference, { minItems: 1, uniqueItems: true }),
     entrypoint: DeliveryFilePathSchema,
     verifyJwt: Boolean2()
   }, objectOptions);
@@ -10173,7 +10215,7 @@ var init_delivery_schema = __esm(() => {
     version: Literal(1),
     execution: Optional(WorkerExecutionSchema),
     targets: Optional(_Array_(_Object_({
-      name: String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" }),
+      name: targetName,
       kind,
       modules: Optional(_Array_(reference, { minItems: 1, uniqueItems: true })),
       isolation: Optional(isolation),
@@ -10181,6 +10223,7 @@ var init_delivery_schema = __esm(() => {
       compute: Optional(ComputeResourcesSchema),
       function: Optional(functionTarget)
     }, objectOptions))),
+    functions: Optional(_Array_(automaticFunction, { maxItems: 32 })),
     runtime: Optional(_Object_({
       processIsolation: Boolean2(),
       durableQueue: Boolean2(),

package/dist/delivery-function.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Wrap a module-backed Function target in the host-owned application factory.
+ * The generated application is already in scope as `createCompiledModules`.
+ */
+export declare function renderDeliveryFunctionEntry(generatedDirectory: string, hostPath: string): string;
+/** Re-export a standalone Edge Function entrypoint without requiring a compiler app graph. */
+export declare function renderStandaloneFunctionEntry(generatedDirectory: string, entrypointPath: string): string;

package/dist/index.js

@@ -3437,6 +3437,7 @@ ${procedureMethods.join(`
 function renderOpenApi(graph, options) {
   const rootDir = options?.rootDir ?? process.cwd();
   const outDir = options?.outDir ?? process.cwd();
+  const snapshots = options?.openApi?.snapshots !== false;
   const imports = new ImportManager;
   const schemaLocals = new Map;
   const schemaComponents = new Map;
@@ -3932,14 +3933,18 @@ function renderOpenApi(graph, options) {
     "  };",
     "}",
     "",
-    "export const OPENAPI_DOCUMENT = createOpenApiDocument();",
-    "",
-    "export function serializeOpenApiDocument(document: OpenApiDocument = OPENAPI_DOCUMENT, space = 2): string {",
+    ...snapshots ? [
+      "export const OPENAPI_DOCUMENT = /* @__PURE__ */ createOpenApiDocument();",
+      ""
+    ] : [],
+    `export function serializeOpenApiDocument(document: OpenApiDocument = ${snapshots ? "OPENAPI_DOCUMENT" : "createOpenApiDocument()"}, space = 2): string {`,
     '  return JSON.stringify(document, null, space) + "\\n";',
     "}",
     "",
-    "export const OPENAPI_JSON = serializeOpenApiDocument();",
-    ""
+    ...snapshots ? [
+      "export const OPENAPI_JSON = /* @__PURE__ */ serializeOpenApiDocument();",
+      ""
+    ] : []
   ].join(`
 `);
 }
@@ -15049,10 +15054,27 @@ function parseDeliveryOptions(value) {
     throw new DeliveryConfigurationError;
   }
   for (const target of value.targets ?? []) {
-    const invalidShape = target.kind === "function" ? target.function === undefined || target.modules !== undefined || target.compute !== undefined : target.modules === undefined || target.function !== undefined;
+    const invalidShape = target.kind === "function" ? target.function === undefined || target.compute !== undefined : target.modules === undefined || target.function !== undefined;
     if (invalidShape)
       throw new DeliveryConfigurationError;
   }
+  const targetNames = new Set((value.targets ?? []).map((target) => target.name));
+  const functionSlugs = new Set;
+  for (const target of value.targets ?? []) {
+    if (target.function !== undefined && functionSlugs.has(target.function.slug)) {
+      throw new DeliveryConfigurationError;
+    }
+    if (target.function !== undefined)
+      functionSlugs.add(target.function.slug);
+  }
+  for (const declared of value.functions ?? []) {
+    const name = declared.name ?? declared.slug;
+    if (targetNames.has(name) || functionSlugs.has(declared.slug)) {
+      throw new DeliveryConfigurationError;
+    }
+    targetNames.add(name);
+    functionSlugs.add(declared.slug);
+  }
   const migrations = value.build?.migrations ?? [];
   try {
     validateWorkerExecution(value.execution?.groups ?? []);
@@ -15062,14 +15084,30 @@ function parseDeliveryOptions(value) {
   if (new Set(migrations.map((item) => item.version)).size !== migrations.length || new Set(migrations.map((item) => item.source)).size !== migrations.length || migrations.some((item) => BigInt(item.version) > 9223372036854775807n || !/\.sql$/i.test(item.source) || item.source.split("/").includes("node_modules"))) {
     throw new DeliveryConfigurationError;
   }
-  return value;
+  if (value.functions === undefined || value.functions.length === 0)
+    return value;
+  const targets = [...value.targets ?? []];
+  for (const declared of value.functions) {
+    targets.push({
+      name: declared.name ?? declared.slug,
+      kind: "function",
+      modules: [...declared.modules],
+      function: {
+        slug: declared.slug,
+        entrypoint: declared.entrypoint,
+        verifyJwt: declared.verifyJwt
+      }
+    });
+  }
+  const { functions: _expandedFunctions, ...rest } = value;
+  return { ...rest, targets };
 }
 function parseDeliveryPlanResult(value) {
   if (!Check2(DeliveryPlanResultSchema, value))
     throw new Error("Invalid delivery plan result.");
   return value;
 }
-var objectOptions, reference, references, kind, isolation, mode, DeliveryFilePathSchema, functionTarget, DeliveryOptionsSchema, DeliveryDiagnosticSchema, routeSchema, jobSchema, DeliveryTargetSchema, DeliveryPlanSchema, DeliveryPlanResultSchema, DeliveryConfigurationError;
+var objectOptions, reference, references, kind, isolation, targetName, functionSlug, mode, DeliveryFilePathSchema, functionTarget, automaticFunction, DeliveryOptionsSchema, DeliveryDiagnosticSchema, routeSchema, jobSchema, DeliveryTargetSchema, DeliveryPlanSchema, DeliveryPlanResultSchema, DeliveryConfigurationError;
 var init_delivery_schema = __esm(() => {
   init_build();
   init_value2();
@@ -15079,13 +15117,22 @@ var init_delivery_schema = __esm(() => {
   references = _Array_(reference, { uniqueItems: true });
   kind = Union([Literal("api"), Literal("jobs"), Literal("webhook"), Literal("function")]);
   isolation = Union([Literal("shared"), Literal("process")]);
+  targetName = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
+  functionSlug = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
   mode = Union([Literal("required"), Literal("none")]);
   DeliveryFilePathSchema = String2({
     maxLength: 512,
     pattern: "^(?:[A-Za-z0-9_-][A-Za-z0-9_.-]*/)*[A-Za-z0-9_-][A-Za-z0-9_.-]*$"
   });
   functionTarget = _Object_({
-    slug: String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" }),
+    slug: functionSlug,
+    entrypoint: DeliveryFilePathSchema,
+    verifyJwt: Boolean2()
+  }, objectOptions);
+  automaticFunction = _Object_({
+    name: Optional(targetName),
+    slug: functionSlug,
+    modules: _Array_(reference, { minItems: 1, uniqueItems: true }),
     entrypoint: DeliveryFilePathSchema,
     verifyJwt: Boolean2()
   }, objectOptions);
@@ -15093,7 +15140,7 @@ var init_delivery_schema = __esm(() => {
     version: Literal(1),
     execution: Optional(WorkerExecutionSchema),
     targets: Optional(_Array_(_Object_({
-      name: String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" }),
+      name: targetName,
       kind,
       modules: Optional(_Array_(reference, { minItems: 1, uniqueItems: true })),
       isolation: Optional(isolation),
@@ -15101,6 +15148,7 @@ var init_delivery_schema = __esm(() => {
       compute: Optional(ComputeResourcesSchema),
       function: Optional(functionTarget)
     }, objectOptions))),
+    functions: Optional(_Array_(automaticFunction, { maxItems: 32 })),
     runtime: Optional(_Object_({
       processIsolation: Boolean2(),
       durableQueue: Boolean2(),
@@ -15405,7 +15453,7 @@ function parseDeliveryBuildManifest(value) {
   }
   for (const object of value.objects) {
     const target = value.plan.targets.find((target) => target.name === object.name);
-    if (["bun-worker-application", "go-worker-application", "scriptc-worker-application"].includes(object.entryKind) && target?.kind !== "jobs" || object.entryKind === "bun-http-application" && target?.kind === "jobs") {
+    if (["bun-worker-application", "go-worker-application", "scriptc-worker-application"].includes(object.entryKind) && target?.kind !== "jobs" || object.entryKind === "bun-http-application" && target?.kind === "jobs" || object.entryKind === "bun-function-application" && target?.kind !== "function" || target?.kind === "function" && object.entryKind !== "bun-function-application") {
       throw new Error("Delivery executable kind does not match its target.");
     }
     if (new Set(object.files.map((file) => file.path)).size !== object.files.length || !object.files.some((file) => file.path === object.entrypoint) || deliveryObjectDigest(object) !== object.objectId) {
@@ -15449,6 +15497,7 @@ var init_delivery_build_schema = __esm(() => {
       Literal("compiled-module-factory"),
       Literal("bun-http-application"),
       Literal("bun-worker-application"),
+      Literal("bun-function-application"),
       Literal("go-worker-application"),
       Literal("scriptc-worker-application")
     ]),
@@ -16522,7 +16571,7 @@ var init_application_release = __esm(() => {
 });
 
 // node_modules/@supacloud/delivery/src/application-configuration.ts
-var ApplicationConfigurationIdSchema, targetName, variableName2, kind3, hosts, bunVersion, ApplicationConfigurationSchema, ApplicationConfigurationWriteSchema, ApplicationConfigurationViewSchema, APPLICATION_RESERVED_ENVIRONMENT_NAMES;
+var ApplicationConfigurationIdSchema, targetName2, variableName2, kind3, hosts, bunVersion, ApplicationConfigurationSchema, ApplicationConfigurationWriteSchema, ApplicationConfigurationViewSchema, APPLICATION_RESERVED_ENVIRONMENT_NAMES;
 var init_application_configuration = __esm(() => {
   init_build();
   init_value2();
@@ -16530,7 +16579,7 @@ var init_application_configuration = __esm(() => {
   ApplicationConfigurationIdSchema = String2({
     pattern: "^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$"
   });
-  targetName = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
+  targetName2 = String2({ pattern: "^[a-z][a-z0-9-]{0,62}$" });
   variableName2 = String2({ pattern: "^[A-Z][A-Z0-9_]{0,127}$" });
   kind3 = Union([Literal("http"), Literal("worker")]);
   hosts = _Array_(String2({ minLength: 1, maxLength: 253 }), { maxItems: 32, uniqueItems: true });
@@ -16538,7 +16587,7 @@ var init_application_configuration = __esm(() => {
   ApplicationConfigurationSchema = _Object_({
     bun_version: bunVersion,
     targets: _Array_(_Object_({
-      name: targetName,
+      name: targetName2,
       kind: kind3,
       hosts,
       environment: Record(variableName2, String2({ maxLength: 16384 }), {
@@ -16561,7 +16610,7 @@ var init_application_configuration = __esm(() => {
     created_at: String2(),
     bun_version: bunVersion,
     targets: _Array_(_Object_({
-      name: targetName,
+      name: targetName2,
       kind: kind3,
       hosts,
       environment_names: _Array_(variableName2, { maxItems: 128, uniqueItems: true })
@@ -22990,7 +23039,7 @@ function createDeliveryPlan(graph, input, validation) {
       name: declaration.name,
       kind: "function",
       isolation: "shared",
-      roots: [],
+      roots: sorted(declaration.modules ?? []),
       modules: [],
       routes: [],
       jobs: [],
@@ -23778,6 +23827,53 @@ interface DeliveryWorkerHost {
 `;
 }
 
+// src/delivery-function.ts
+function renderDeliveryFunctionEntry(generatedDirectory, hostPath) {
+  const specifier = relativeImportPath(generatedDirectory, hostPath);
+  return `
+import * as deliveryFunctionHostModule from ${JSON.stringify(specifier)};
+
+type DeliveryFunctionHost = {
+  fetch(request: Request): Response | Promise<Response>;
+};
+
+const createDeliveryFunctionHost = (deliveryFunctionHostModule as {
+  createDeliveryApplication?: (
+    modules: ReturnType<typeof createCompiledModules>,
+    lifecycle: { signal: AbortSignal },
+  ) => DeliveryFunctionHost | Promise<DeliveryFunctionHost>;
+}).createDeliveryApplication;
+if (typeof createDeliveryFunctionHost !== "function") {
+  throw new Error("Invalid delivery Function host.");
+}
+const deliveryCreateHost = createDeliveryFunctionHost;
+
+const deliveryFunctionLifecycle = new AbortController();
+let deliveryFunctionHost: Promise<DeliveryFunctionHost> | undefined;
+function deliveryHost(): Promise<DeliveryFunctionHost> {
+  return deliveryFunctionHost ??= Promise.resolve(
+    deliveryCreateHost(createCompiledModules(), { signal: deliveryFunctionLifecycle.signal }),
+  );
+}
+
+export default {
+  async fetch(request: Request): Promise<Response> {
+    return (await deliveryHost()).fetch(request);
+  },
+};
+`;
+}
+function renderStandaloneFunctionEntry(generatedDirectory, entrypointPath) {
+  const specifier = relativeImportPath(generatedDirectory, entrypointPath);
+  return `
+import * as deliveryFunctionEntry from ${JSON.stringify(specifier)};
+
+const deliveryFunctionDefault: unknown = (deliveryFunctionEntry as { default?: unknown }).default
+  ?? deliveryFunctionEntry;
+export default deliveryFunctionDefault;
+`;
+}
+
 // src/delivery-migrations.ts
 init_delivery_files2();
 import { resolve as resolve12 } from "node:path";
@@ -23873,14 +23969,6 @@ async function buildDeliveryProject(options, delivery) {
     const planned = createDeliveryPlan({ ...checked.graph, diagnostics: checked.diagnostics }, settings, options);
     if (!planned.ok)
       return failed(planned.diagnostics);
-    if (planned.plan.targets.some((target) => target.kind === "function")) {
-      return failed([{
-        severity: "error",
-        code: "delivery-function-build-unsupported",
-        message: "Function target rendering is not implemented yet; the delivery build only produces HTTP and Worker application objects.",
-        suggestion: "Declare HTTP/Worker application targets for now; Function and schedule delivery is tracked separately."
-      }]);
-    }
     if (options.graphql && checked.mismatches.some((mismatch) => mismatch.startsWith("graphql"))) {
       throw new Error("Refresh GraphQL artifacts with compile before building independent targets.");
     }
@@ -23910,6 +23998,17 @@ async function buildDeliveryProject(options, delivery) {
         hosts.set(app.target, { path, kind, hash: digest(await readOwned(sourceRoot, path)) });
       }
     }
+    for (const target of planned.plan.targets) {
+      if (target.kind !== "function" || target.modules.length === 0 || target.function === undefined)
+        continue;
+      if (hosts.has(target.name))
+        throw new Error("Duplicate delivery application host.");
+      const path = resolve13(sourceRoot, target.function.entrypoint);
+      if (inside(generatedRoot, path) || !/\.[cm]?ts$/.test(path)) {
+        throw new Error("Function hosts require application TypeScript source.");
+      }
+      hosts.set(target.name, { path, kind: "function", hash: digest(await readOwned(sourceRoot, path)) });
+    }
     phase = "migration-inputs";
     const migrations = await prepareDeliveryMigrations(project, generatedRoot, settings.build?.migrations);
     phase = "output-ownership";
@@ -23964,19 +24063,38 @@ async function buildDeliveryProject(options, delivery) {
       const stage = await mkdtemp(join9(objectRoot, ".build-"));
       temporary.push(stage);
       const generatedDirectory = join9(objectRoot, "0".repeat(64), "generated");
-      const rendered = renderDeliveryTarget(checked.graph, target, {
+      const host = hosts.get(target.name);
+      const standaloneFunction = target.kind === "function" && target.modules.length === 0;
+      const rendered = standaloneFunction ? undefined : renderDeliveryTarget(checked.graph, target, {
         ...options,
         rootDir: sourceRoot,
         outDir: generatedDirectory
       });
-      const host = hosts.get(target.name);
-      const entryKind = host?.kind === "http" ? "bun-http-application" : host?.kind === "worker" ? "bun-worker-application" : "compiled-module-factory";
-      const applicationCode = rendered.applicationCode + (host?.kind === "http" ? renderDeliveryHttpEntry(generatedDirectory, host.path) : host?.kind === "worker" ? renderDeliveryWorkerEntry(generatedDirectory, host.path) : "");
-      const generated = {
-        "application.ts": applicationCode,
-        ...rendered.clientCode === undefined ? {} : { "client.ts": rendered.clientCode },
-        ...rendered.permissionsCode === undefined ? {} : { "permissions.ts": rendered.permissionsCode }
-      };
+      let entryKind;
+      let applicationCode;
+      let generated;
+      if (standaloneFunction) {
+        if (target.function === undefined)
+          throw new Error("Function target requires an entrypoint descriptor.");
+        const entrypointPath = resolve13(sourceRoot, target.function.entrypoint);
+        if (inside(generatedRoot, entrypointPath) || !/\.[cm]?ts$/.test(entrypointPath)) {
+          throw new Error("Standalone Function entrypoints require application TypeScript source.");
+        }
+        entryKind = "bun-function-application";
+        applicationCode = renderStandaloneFunctionEntry(generatedDirectory, entrypointPath);
+        generated = { "function.ts": applicationCode };
+      } else {
+        if (target.kind === "function" && host?.kind !== "function") {
+          throw new Error("Module-backed Function targets require an entrypoint host.");
+        }
+        entryKind = target.kind === "function" ? "bun-function-application" : host?.kind === "http" ? "bun-http-application" : host?.kind === "worker" ? "bun-worker-application" : "compiled-module-factory";
+        applicationCode = rendered.applicationCode + (host?.kind === "http" ? renderDeliveryHttpEntry(generatedDirectory, host.path) : host?.kind === "worker" ? renderDeliveryWorkerEntry(generatedDirectory, host.path) : host?.kind === "function" ? renderDeliveryFunctionEntry(generatedDirectory, host.path) : "");
+        generated = {
+          "application.ts": applicationCode,
+          ...rendered.clientCode === undefined ? {} : { "client.ts": rendered.clientCode },
+          ...rendered.permissionsCode === undefined ? {} : { "permissions.ts": rendered.permissionsCode }
+        };
+      }
       const unsafe = scanGeneratedArtifacts(generated, true);
       if (unsafe.some((item) => item.severity === "error"))
         return failed(unsafe);
@@ -24019,9 +24137,14 @@ async function buildDeliveryProject(options, delivery) {
       for (const [path, bytes] of bundled.files)
         await writeArtifact(stage, path, bytes);
       await writeArtifact(stage, "bundle/package.json", canonical2({ type: "module", private: true }));
-      await writeArtifact(stage, "bundle/app.manifest.json", rendered.manifestJson);
-      await writeArtifact(stage, "bundle/execution-context.json", rendered.executionSnapshot);
-      await writeArtifact(stage, "bundle/application-development.json", rendered.applicationDevelopment);
+      if (target.kind === "function" && target.function !== undefined) {
+        await writeArtifact(stage, "bundle/function.json", canonical2(target.function));
+      }
+      if (rendered !== undefined) {
+        await writeArtifact(stage, "bundle/app.manifest.json", rendered.manifestJson);
+        await writeArtifact(stage, "bundle/execution-context.json", rendered.executionSnapshot);
+        await writeArtifact(stage, "bundle/application-development.json", rendered.applicationDevelopment);
+      }
       for (const [path, bytes] of migrations.files)
         await writeArtifact(stage, path, bytes);
       await writeArtifact(stage, "bundle/target.json", canonical2({
@@ -24839,7 +24962,7 @@ import { readFileSync as readFileSync4 } from "node:fs";
 import { resolve as resolve17 } from "node:path";
 
 // src/migration-app-version.ts
-var MIGRATION_APP_VERSION = "0.33.0";
+var MIGRATION_APP_VERSION = "0.34.0";
 
 // src/migration-elysia-version.ts
 var MIGRATION_ELYSIA_VERSION = "0.36.2";
@@ -25720,7 +25843,11 @@ async function loadGeneratedOpenApiDocument(modulePath) {
     const loaded = await import(moduleUrl.href);
     if (!isRecord(loaded))
       throw new OpenApiDocumentError;
-    return parseOpenApiDocument(loaded["OPENAPI_DOCUMENT"]);
+    if ("OPENAPI_DOCUMENT" in loaded)
+      return parseOpenApiDocument(loaded["OPENAPI_DOCUMENT"]);
+    if (typeof loaded["createOpenApiDocument"] !== "function")
+      throw new OpenApiDocumentError;
+    return parseOpenApiDocument(await loaded["createOpenApiDocument"]());
   } catch (error) {
     if (error instanceof OpenApiDocumentError)
       throw error;

package/dist/migration-app-version.d.ts

@@ -1 +1 @@
-export declare const MIGRATION_APP_VERSION = "0.33.0";
+export declare const MIGRATION_APP_VERSION = "0.34.0";

package/dist/types.d.ts

@@ -552,6 +552,8 @@ export type OpenApiSecurityScheme = {
     description?: string;
 };
 export interface OpenApiOptions {
+    /** Emit eager document and JSON snapshots for compatibility. Set false for factory-only imports. Defaults to true. */
+    snapshots?: boolean;
     title?: string;
     version?: string;
     description?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.51.2",
+  "version": "0.52.0",
   "description": "Static compiler for @supacloud/app metadata: builds the application graph from AST, validates it, and generates reflection-free factory code",
   "type": "module",
   "main": "./dist/index.js",
@@ -58,7 +58,7 @@
   },
   "dependencies": {
     "@supacloud/db": "0.20.1",
-    "@supacloud/delivery": "0.21.1",
+    "@supacloud/delivery": "0.22.0",
     "typebox": "1.4.2",
     "@graphql-codegen/core": "^6.2.2",
     "@graphql-codegen/typed-document-node": "^7.2.0",