@unieojs/unio-generic-adapter 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# @unieojs/unio-generic-adapter
+
+Generic Unio adapter for projects that already know their static output,
+server function bundle, routes, middleware, and optional edge bundle.
+
+The adapter emits `.unio/output` directly. It keeps route matches exactly as
+provided, so AI Pages wildcard-host deployments should use root-domain paths
+such as `/`, `/api/:path*`, and `/api/_supabase/:path*` instead of
+`/p/{platform}/{platformId}`.
+
+```ts
+import {
+  buildGenericOutput,
+  emitGenericUnioOutput,
+  loadConfig,
+} from "@unieojs/unio-generic-adapter";
+
+await emitGenericUnioOutput({
+  cwd: projectRoot,
+  build: {
+    staticDir: "dist",
+  },
+  serverFunctions: [
+    {
+      name: "server",
+      sourceDir: "server",
+      entry: "index.js",
+    },
+  ],
+  edgeBundles: [
+    {
+      name: "app",
+      sourceDir: "edge",
+      entry: "index.js",
+    },
+  ],
+  routes: [
+    { id: "home", match: "/", type: "assets", entry: "static/index.html" },
+    {
+      id: "api",
+      match: "/api/:path*",
+      type: "serverFunction",
+      serverFunction: "server",
+    },
+  ],
+  middleware: [
+    {
+      name: "supabase-edge",
+      match: ["/api/_supabase/:path*"],
+      runtime: "edge",
+      entry: "edge/app/index.js",
+    },
+  ],
+});
+```
+
+`apc build --generic` uses the package-level CLI boundary:
+
+```ts
+const loaded = await loadConfig({ projectDir, configPath, outputDir });
+// loaded.build.command is executed by apc, then:
+await buildGenericOutput({ projectDir, configPath, outputDir });
+```
+
+`server-functions/<name>/serverFunction.json` is generated for shared
+`unistackfaasruntime` deployment with `handlerProtocol: "nodejs"`.
+
+`apc pack` / `apc publish` materializes `uboaMetadata.tgz` from the root
+metadata manifests (`unio.json`, `routes.json`, `middleware.json`,
+`artifacts.json`, `features.json`, and `observability.json`).

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import type { BuildGenericOutputOptions, GenericConfig, LoadGenericConfigOptions } from "./types.js";
+export declare function loadConfig(options: LoadGenericConfigOptions): Promise<GenericConfig>;
+export declare function buildGenericOutput(options: BuildGenericOutputOptions): Promise<import("./types.js").GeneratedGenericUboa>;

package/dist/config.js

@@ -0,0 +1,74 @@
+import { promises as fs, rmSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import ts from "typescript";
+import { emitGenericUnioOutput } from "./emit.js";
+const tempConfigDirs = new Set();
+let tempConfigCleanupRegistered = false;
+export async function loadConfig(options) {
+    const configPath = path.resolve(options.configPath);
+    const loaded = await loadConfigModule(configPath);
+    const config = normalizeConfig(loaded);
+    return {
+        ...config,
+        cwd: options.projectDir,
+        outputDir: options.outputDir,
+    };
+}
+export async function buildGenericOutput(options) {
+    const config = await loadConfig(options);
+    return emitGenericUnioOutput({
+        ...config,
+        cwd: options.projectDir,
+        outputDir: options.outputDir,
+    });
+}
+async function loadConfigModule(configPath) {
+    if (configPath.endsWith(".json")) {
+        return JSON.parse(await fs.readFile(configPath, "utf8"));
+    }
+    if (configPath.endsWith(".ts")) {
+        return loadTypeScriptConfig(configPath);
+    }
+    return importFresh(configPath);
+}
+async function loadTypeScriptConfig(configPath) {
+    const source = await fs.readFile(configPath, "utf8");
+    const transpiled = ts.transpileModule(source, {
+        compilerOptions: {
+            module: ts.ModuleKind.ES2022,
+            target: ts.ScriptTarget.ES2022,
+            esModuleInterop: true,
+        },
+        fileName: configPath,
+    });
+    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "unio-config-"));
+    const tempFile = path.join(tempDir, "config.mjs");
+    registerTempConfigCleanup(tempDir);
+    await fs.writeFile(tempFile, transpiled.outputText, "utf8");
+    return importFresh(tempFile);
+}
+async function importFresh(filePath) {
+    const mod = await import(`${pathToFileURL(filePath).href}?t=${Date.now()}`);
+    return mod.default ?? mod;
+}
+function registerTempConfigCleanup(tempDir) {
+    tempConfigDirs.add(tempDir);
+    if (tempConfigCleanupRegistered) {
+        return;
+    }
+    tempConfigCleanupRegistered = true;
+    process.once("exit", () => {
+        for (const dir of tempConfigDirs) {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+}
+function normalizeConfig(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("unio config must export an object");
+    }
+    return value;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/emit.d.ts

@@ -0,0 +1,2 @@
+import type { EmitGenericUnioOutputOptions, GeneratedGenericUboa } from "./types.js";
+export declare function emitGenericUnioOutput(options: EmitGenericUnioOutputOptions): Promise<GeneratedGenericUboa>;

package/dist/emit.js

@@ -0,0 +1,164 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const ADAPTER_PACKAGE = "@unieojs/unio-generic-adapter";
+const UBOA_VERSION = "1.0.0";
+const SHARED_FUNCTION_APP_NAME = "unistackfaasruntime";
+function toPosix(p) {
+    return p.split(path.sep).join("/");
+}
+function outputRoot(cwd, outputDir) {
+    return path.resolve(cwd, outputDir ?? ".unio/output");
+}
+function resolveProjectPath(cwd, value) {
+    return path.isAbsolute(value) ? value : path.join(cwd, value);
+}
+function relativeSource(cwd, value) {
+    const absolutePath = resolveProjectPath(cwd, value);
+    const relativePath = path.relative(cwd, absolutePath);
+    if (!relativePath || relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
+        return toPosix(value);
+    }
+    return toPosix(relativePath);
+}
+function framework(config) {
+    return {
+        name: config?.name ?? "generic",
+        version: config?.version ?? "unknown",
+        adapter: ADAPTER_PACKAGE,
+    };
+}
+async function writeJson(filePath, value) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+async function copyDirectory(source, dest) {
+    await fs.mkdir(path.dirname(dest), { recursive: true });
+    await fs.cp(source, dest, { recursive: true });
+}
+async function emitStaticFiles(root, cwd, staticDir) {
+    if (!staticDir)
+        return [];
+    await copyDirectory(resolveProjectPath(cwd, staticDir), path.join(root, "static"));
+    return [{ id: "static", resourceKind: "assets", path: "static" }];
+}
+async function emitServerFunction(root, cwd, config, frameworkConfig) {
+    const functionDir = path.join(root, "server-functions", config.name);
+    await copyDirectory(resolveProjectPath(cwd, config.sourceDir), functionDir);
+    const descriptor = {
+        name: config.name,
+        runtime: config.runtime ?? "nodejs22",
+        entry: toPosix(config.entry),
+        handler: config.handler ?? "default",
+        handlerProtocol: "nodejs",
+        memory: config.memory ?? 512,
+        maxDuration: config.maxDuration ?? 10,
+        environment: config.environment ?? {},
+        bindings: config.bindings ?? {},
+        framework: framework(frameworkConfig),
+        source: {
+            sourceDir: relativeSource(cwd, config.sourceDir),
+            entry: toPosix(config.entry),
+        },
+        deployment: {
+            mode: "shared",
+            functionAppName: SHARED_FUNCTION_APP_NAME,
+        },
+    };
+    await writeJson(path.join(functionDir, "serverFunction.json"), descriptor);
+    return {
+        id: config.name,
+        resourceKind: "serverFunction",
+        path: `server-functions/${config.name}`,
+    };
+}
+async function emitEdgeBundle(root, cwd, config, frameworkConfig) {
+    const edgeDir = path.join(root, "edge", config.name);
+    await copyDirectory(resolveProjectPath(cwd, config.sourceDir), edgeDir);
+    const descriptor = {
+        name: config.name,
+        runtime: config.runtime ?? "edge",
+        entry: toPosix(config.entry),
+        handler: config.handler ?? "default",
+        handlerProtocol: "fetch",
+        bindings: config.bindings ?? {},
+        framework: framework(frameworkConfig),
+        source: {
+            sourceDir: relativeSource(cwd, config.sourceDir),
+            entry: toPosix(config.entry),
+        },
+    };
+    await writeJson(path.join(edgeDir, "edge.json"), descriptor);
+    return {
+        id: config.name,
+        resourceKind: "edge",
+        path: `edge/${config.name}`,
+    };
+}
+function buildCapabilities(hasStatic, routes, middleware, serverFunctions, edgeBundles) {
+    const hasServerFunction = serverFunctions.length > 0 ||
+        routes.some((route) => route.type === "serverFunction") ||
+        middleware.some((item) => item.runtime === "serverless");
+    const hasEdge = edgeBundles.length > 0 ||
+        routes.some((route) => route.type === "edgeFunction") ||
+        middleware.some((item) => item.runtime === "edge");
+    return {
+        static: hasStatic ? "supported" : "unsupported",
+        routes: routes.length > 0 ? "supported" : "unsupported",
+        serverlessFunction: hasServerFunction ? "supported" : "unsupported",
+        serverFunctionIntrospection: hasServerFunction ? "supported" : "unsupported",
+        restRouteIntrospection: hasServerFunction ? "supported" : "unsupported",
+        edgeMiddleware: hasEdge ? "supported" : "unsupported",
+        imageOptimization: "unsupported",
+    };
+}
+export async function emitGenericUnioOutput(options) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const root = outputRoot(cwd, options.outputDir);
+    const routes = options.routes ?? [];
+    const middleware = options.middleware ?? [];
+    const serverFunctions = options.serverFunctions ?? [];
+    const edgeBundles = options.edgeBundles ?? [];
+    await fs.rm(root, { recursive: true, force: true });
+    await fs.mkdir(root, { recursive: true });
+    const artifacts = [
+        ...(await emitStaticFiles(root, cwd, options.build?.staticDir)),
+    ];
+    for (const serverFunction of serverFunctions) {
+        artifacts.push(await emitServerFunction(root, cwd, serverFunction, options.framework));
+    }
+    for (const edgeBundle of edgeBundles) {
+        artifacts.push(await emitEdgeBundle(root, cwd, edgeBundle, options.framework));
+    }
+    const warnings = [];
+    const capabilities = buildCapabilities(artifacts.some((artifact) => artifact.resourceKind === "assets"), routes, middleware, serverFunctions, edgeBundles);
+    const generated = {
+        outputDir: root,
+        routes,
+        middleware,
+        artifacts,
+        capabilities,
+        warnings,
+    };
+    await writeJson(path.join(root, "unio.json"), {
+        version: UBOA_VERSION,
+        framework: framework(options.framework),
+        build: {
+            contentVersion: options.contentVersion ?? "local",
+            buildId: options.buildId ?? "local",
+        },
+        capabilities,
+        warnings,
+    });
+    await writeJson(path.join(root, "routes.json"), routes);
+    await writeJson(path.join(root, "middleware.json"), middleware);
+    await writeJson(path.join(root, "artifacts.json"), { artifacts });
+    await writeJson(path.join(root, "features.json"), { features: [] });
+    await writeJson(path.join(root, "observability.json"), {
+        adapter: ADAPTER_PACKAGE,
+        framework: options.framework?.name ?? "generic",
+        buildId: options.buildId ?? "local",
+    });
+    await options.afterEmit?.(generated);
+    return generated;
+}
+//# sourceMappingURL=emit.js.map

package/dist/emit.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { buildGenericOutput, loadConfig } from "./config.js";
+export { emitGenericUnioOutput } from "./emit.js";
+export type { BuildGenericOutputOptions, EmitGenericUnioOutputOptions, GeneratedGenericUboa, GenericArtifact, GenericArtifactResourceKind, GenericAssetsRoute, GenericBuildConfig, GenericConfig, GenericCapabilities, GenericEdgeBundleConfig, GenericEdgeBundleDescriptor, GenericEdgeFunctionRoute, GenericEdgeMiddleware, GenericFrameworkConfig, GenericMiddleware, GenericRoute, GenericServerFunctionConfig, GenericServerFunctionDescriptor, GenericServerFunctionRoute, GenericServerlessMiddleware, LoadGenericConfigOptions, } from "./types.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { buildGenericOutput, loadConfig } from "./config.js";
+export { emitGenericUnioOutput } from "./emit.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,149 @@
+export type CapabilityStatus = "supported" | "partial" | "degraded" | "unsupported";
+export interface GenericCapabilities {
+    static: CapabilityStatus;
+    routes: CapabilityStatus;
+    serverlessFunction: CapabilityStatus;
+    serverFunctionIntrospection: CapabilityStatus;
+    restRouteIntrospection: CapabilityStatus;
+    edgeMiddleware: CapabilityStatus;
+    imageOptimization: CapabilityStatus;
+}
+export interface GenericBuildConfig {
+    command?: string;
+    staticDir?: string;
+}
+export interface GenericFrameworkConfig {
+    name?: string;
+    version?: string;
+}
+export interface GenericServerFunctionConfig {
+    name: string;
+    sourceDir: string;
+    entry: string;
+    handler?: string;
+    runtime?: string;
+    memory?: number;
+    maxDuration?: number;
+    environment?: Record<string, unknown>;
+    bindings?: Record<string, unknown>;
+}
+export interface GenericEdgeBundleConfig {
+    name: string;
+    sourceDir: string;
+    entry: string;
+    handler?: string;
+    runtime?: string;
+    bindings?: Record<string, unknown>;
+}
+interface GenericRouteBase {
+    id: string;
+    match: string;
+}
+export interface GenericAssetsRoute extends GenericRouteBase {
+    type: "assets";
+    entry: string;
+    serverFunction?: never;
+    edgeFunction?: never;
+    methods?: never;
+}
+export interface GenericServerFunctionRoute extends GenericRouteBase {
+    type: "serverFunction";
+    serverFunction: string;
+    methods?: string[];
+    entry?: never;
+    edgeFunction?: never;
+}
+export interface GenericEdgeFunctionRoute extends GenericRouteBase {
+    type: "edgeFunction";
+    edgeFunction: string;
+    entry?: never;
+    serverFunction?: never;
+    methods?: never;
+}
+export type GenericRoute = GenericAssetsRoute | GenericServerFunctionRoute | GenericEdgeFunctionRoute;
+interface GenericMiddlewareBase {
+    name: string;
+    match: string[];
+}
+export interface GenericEdgeMiddleware extends GenericMiddlewareBase {
+    runtime: "edge";
+    entry: string;
+    serverFunction?: never;
+}
+export interface GenericServerlessMiddleware extends GenericMiddlewareBase {
+    runtime: "serverless";
+    serverFunction: string;
+    entry?: never;
+}
+export type GenericMiddleware = GenericEdgeMiddleware | GenericServerlessMiddleware;
+export type GenericArtifactResourceKind = "assets" | "serverFunction" | "edge" | "apiSchema";
+export interface GenericArtifact {
+    id: string;
+    resourceKind: GenericArtifactResourceKind;
+    path: string;
+    schemaFormat?: "oneapi";
+    describes?: {
+        resourceKind?: GenericArtifactResourceKind;
+        id?: string;
+    };
+}
+export interface GenericServerFunctionDescriptor {
+    name: string;
+    runtime: string;
+    entry: string;
+    handler: string;
+    handlerProtocol: "nodejs";
+    memory: number;
+    maxDuration: number;
+    environment: Record<string, unknown>;
+    bindings: Record<string, unknown>;
+    framework: Record<string, unknown>;
+    source: Record<string, unknown>;
+    deployment: {
+        mode: "shared";
+        functionAppName: "unistackfaasruntime";
+    };
+    [key: string]: unknown;
+}
+export interface GenericEdgeBundleDescriptor {
+    name: string;
+    runtime: string;
+    entry: string;
+    handler: string;
+    handlerProtocol: "fetch";
+    bindings: Record<string, unknown>;
+    framework: Record<string, unknown>;
+    source: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface GeneratedGenericUboa {
+    outputDir: string;
+    routes: GenericRoute[];
+    middleware: GenericMiddleware[];
+    artifacts: GenericArtifact[];
+    capabilities: GenericCapabilities;
+    warnings: string[];
+}
+export interface EmitGenericUnioOutputOptions {
+    cwd?: string;
+    outputDir?: string;
+    build?: GenericBuildConfig;
+    framework?: GenericFrameworkConfig;
+    buildId?: string;
+    contentVersion?: string;
+    serverFunctions?: GenericServerFunctionConfig[];
+    edgeBundles?: GenericEdgeBundleConfig[];
+    routes?: GenericRoute[];
+    middleware?: GenericMiddleware[];
+    afterEmit?: (result: GeneratedGenericUboa) => void | Promise<void>;
+}
+export interface GenericConfig extends EmitGenericUnioOutputOptions {
+}
+export interface LoadGenericConfigOptions {
+    projectDir: string;
+    configPath: string;
+    outputDir?: string;
+}
+export interface BuildGenericOutputOptions extends LoadGenericConfigOptions {
+}
+export {};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@unieojs/unio-generic-adapter",
+  "version": "0.1.0",
+  "description": "Generic adapter that emits Unio Build Output API manifests.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unieojs/unio-adapters.git",
+    "directory": "packages/generic"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --import tsx --test \"test/**/*.test.ts\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.8.0"
+  },
+  "dependencies": {
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=18.19.0"
+  },
+  "license": "MIT"
+}

package/src/config.ts

@@ -0,0 +1,93 @@
+import { promises as fs, rmSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+import ts from "typescript";
+
+import { emitGenericUnioOutput } from "./emit.js";
+import type {
+  BuildGenericOutputOptions,
+  GenericConfig,
+  LoadGenericConfigOptions,
+} from "./types.js";
+
+const tempConfigDirs = new Set<string>();
+let tempConfigCleanupRegistered = false;
+
+export async function loadConfig(
+  options: LoadGenericConfigOptions,
+): Promise<GenericConfig> {
+  const configPath = path.resolve(options.configPath);
+  const loaded = await loadConfigModule(configPath);
+  const config = normalizeConfig(loaded);
+  return {
+    ...config,
+    cwd: options.projectDir,
+    outputDir: options.outputDir,
+  };
+}
+
+export async function buildGenericOutput(options: BuildGenericOutputOptions) {
+  const config = await loadConfig(options);
+  return emitGenericUnioOutput({
+    ...config,
+    cwd: options.projectDir,
+    outputDir: options.outputDir,
+  });
+}
+
+async function loadConfigModule(configPath: string): Promise<unknown> {
+  if (configPath.endsWith(".json")) {
+    return JSON.parse(await fs.readFile(configPath, "utf8"));
+  }
+
+  if (configPath.endsWith(".ts")) {
+    return loadTypeScriptConfig(configPath);
+  }
+
+  return importFresh(configPath);
+}
+
+async function loadTypeScriptConfig(configPath: string): Promise<unknown> {
+  const source = await fs.readFile(configPath, "utf8");
+  const transpiled = ts.transpileModule(source, {
+    compilerOptions: {
+      module: ts.ModuleKind.ES2022,
+      target: ts.ScriptTarget.ES2022,
+      esModuleInterop: true,
+    },
+    fileName: configPath,
+  });
+  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "unio-config-"));
+  const tempFile = path.join(tempDir, "config.mjs");
+  registerTempConfigCleanup(tempDir);
+  await fs.writeFile(tempFile, transpiled.outputText, "utf8");
+  return importFresh(tempFile);
+}
+
+async function importFresh(filePath: string): Promise<unknown> {
+  const mod = await import(`${pathToFileURL(filePath).href}?t=${Date.now()}`);
+  return (mod as { default?: unknown }).default ?? mod;
+}
+
+function registerTempConfigCleanup(tempDir: string): void {
+  tempConfigDirs.add(tempDir);
+  if (tempConfigCleanupRegistered) {
+    return;
+  }
+
+  tempConfigCleanupRegistered = true;
+  process.once("exit", () => {
+    for (const dir of tempConfigDirs) {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+}
+
+function normalizeConfig(value: unknown): GenericConfig {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("unio config must export an object");
+  }
+  return value as GenericConfig;
+}

package/src/emit.ts

@@ -0,0 +1,236 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+
+import type {
+  EmitGenericUnioOutputOptions,
+  GeneratedGenericUboa,
+  GenericArtifact,
+  GenericCapabilities,
+  GenericEdgeBundleConfig,
+  GenericEdgeBundleDescriptor,
+  GenericFrameworkConfig,
+  GenericMiddleware,
+  GenericRoute,
+  GenericServerFunctionConfig,
+  GenericServerFunctionDescriptor,
+} from "./types.js";
+
+const ADAPTER_PACKAGE = "@unieojs/unio-generic-adapter";
+const UBOA_VERSION = "1.0.0";
+const SHARED_FUNCTION_APP_NAME = "unistackfaasruntime";
+
+function toPosix(p: string): string {
+  return p.split(path.sep).join("/");
+}
+
+function outputRoot(cwd: string, outputDir?: string): string {
+  return path.resolve(cwd, outputDir ?? ".unio/output");
+}
+
+function resolveProjectPath(cwd: string, value: string): string {
+  return path.isAbsolute(value) ? value : path.join(cwd, value);
+}
+
+function relativeSource(cwd: string, value: string): string {
+  const absolutePath = resolveProjectPath(cwd, value);
+  const relativePath = path.relative(cwd, absolutePath);
+  if (!relativePath || relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
+    return toPosix(value);
+  }
+  return toPosix(relativePath);
+}
+
+function framework(config: GenericFrameworkConfig | undefined): Record<string, unknown> {
+  return {
+    name: config?.name ?? "generic",
+    version: config?.version ?? "unknown",
+    adapter: ADAPTER_PACKAGE,
+  };
+}
+
+async function writeJson(filePath: string, value: unknown): Promise<void> {
+  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  await fs.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+
+async function copyDirectory(source: string, dest: string): Promise<void> {
+  await fs.mkdir(path.dirname(dest), { recursive: true });
+  await fs.cp(source, dest, { recursive: true });
+}
+
+async function emitStaticFiles(
+  root: string,
+  cwd: string,
+  staticDir: string | undefined,
+): Promise<GenericArtifact[]> {
+  if (!staticDir) return [];
+
+  await copyDirectory(resolveProjectPath(cwd, staticDir), path.join(root, "static"));
+  return [{ id: "static", resourceKind: "assets", path: "static" }];
+}
+
+async function emitServerFunction(
+  root: string,
+  cwd: string,
+  config: GenericServerFunctionConfig,
+  frameworkConfig: GenericFrameworkConfig | undefined,
+): Promise<GenericArtifact> {
+  const functionDir = path.join(root, "server-functions", config.name);
+  await copyDirectory(resolveProjectPath(cwd, config.sourceDir), functionDir);
+
+  const descriptor: GenericServerFunctionDescriptor = {
+    name: config.name,
+    runtime: config.runtime ?? "nodejs22",
+    entry: toPosix(config.entry),
+    handler: config.handler ?? "default",
+    handlerProtocol: "nodejs",
+    memory: config.memory ?? 512,
+    maxDuration: config.maxDuration ?? 10,
+    environment: config.environment ?? {},
+    bindings: config.bindings ?? {},
+    framework: framework(frameworkConfig),
+    source: {
+      sourceDir: relativeSource(cwd, config.sourceDir),
+      entry: toPosix(config.entry),
+    },
+    deployment: {
+      mode: "shared",
+      functionAppName: SHARED_FUNCTION_APP_NAME,
+    },
+  };
+
+  await writeJson(path.join(functionDir, "serverFunction.json"), descriptor);
+  return {
+    id: config.name,
+    resourceKind: "serverFunction",
+    path: `server-functions/${config.name}`,
+  };
+}
+
+async function emitEdgeBundle(
+  root: string,
+  cwd: string,
+  config: GenericEdgeBundleConfig,
+  frameworkConfig: GenericFrameworkConfig | undefined,
+): Promise<GenericArtifact> {
+  const edgeDir = path.join(root, "edge", config.name);
+  await copyDirectory(resolveProjectPath(cwd, config.sourceDir), edgeDir);
+
+  const descriptor: GenericEdgeBundleDescriptor = {
+    name: config.name,
+    runtime: config.runtime ?? "edge",
+    entry: toPosix(config.entry),
+    handler: config.handler ?? "default",
+    handlerProtocol: "fetch",
+    bindings: config.bindings ?? {},
+    framework: framework(frameworkConfig),
+    source: {
+      sourceDir: relativeSource(cwd, config.sourceDir),
+      entry: toPosix(config.entry),
+    },
+  };
+
+  await writeJson(path.join(edgeDir, "edge.json"), descriptor);
+  return {
+    id: config.name,
+    resourceKind: "edge",
+    path: `edge/${config.name}`,
+  };
+}
+
+function buildCapabilities(
+  hasStatic: boolean,
+  routes: GenericRoute[],
+  middleware: GenericMiddleware[],
+  serverFunctions: GenericServerFunctionConfig[],
+  edgeBundles: GenericEdgeBundleConfig[],
+): GenericCapabilities {
+  const hasServerFunction =
+    serverFunctions.length > 0 ||
+    routes.some((route) => route.type === "serverFunction") ||
+    middleware.some((item) => item.runtime === "serverless");
+  const hasEdge =
+    edgeBundles.length > 0 ||
+    routes.some((route) => route.type === "edgeFunction") ||
+    middleware.some((item) => item.runtime === "edge");
+
+  return {
+    static: hasStatic ? "supported" : "unsupported",
+    routes: routes.length > 0 ? "supported" : "unsupported",
+    serverlessFunction: hasServerFunction ? "supported" : "unsupported",
+    serverFunctionIntrospection: hasServerFunction ? "supported" : "unsupported",
+    restRouteIntrospection: hasServerFunction ? "supported" : "unsupported",
+    edgeMiddleware: hasEdge ? "supported" : "unsupported",
+    imageOptimization: "unsupported",
+  };
+}
+
+export async function emitGenericUnioOutput(
+  options: EmitGenericUnioOutputOptions,
+): Promise<GeneratedGenericUboa> {
+  const cwd = path.resolve(options.cwd ?? process.cwd());
+  const root = outputRoot(cwd, options.outputDir);
+  const routes = options.routes ?? [];
+  const middleware = options.middleware ?? [];
+  const serverFunctions = options.serverFunctions ?? [];
+  const edgeBundles = options.edgeBundles ?? [];
+
+  await fs.rm(root, { recursive: true, force: true });
+  await fs.mkdir(root, { recursive: true });
+
+  const artifacts: GenericArtifact[] = [
+    ...(await emitStaticFiles(root, cwd, options.build?.staticDir)),
+  ];
+
+  for (const serverFunction of serverFunctions) {
+    artifacts.push(
+      await emitServerFunction(root, cwd, serverFunction, options.framework),
+    );
+  }
+
+  for (const edgeBundle of edgeBundles) {
+    artifacts.push(await emitEdgeBundle(root, cwd, edgeBundle, options.framework));
+  }
+
+  const warnings: string[] = [];
+  const capabilities = buildCapabilities(
+    artifacts.some((artifact) => artifact.resourceKind === "assets"),
+    routes,
+    middleware,
+    serverFunctions,
+    edgeBundles,
+  );
+
+  const generated: GeneratedGenericUboa = {
+    outputDir: root,
+    routes,
+    middleware,
+    artifacts,
+    capabilities,
+    warnings,
+  };
+
+  await writeJson(path.join(root, "unio.json"), {
+    version: UBOA_VERSION,
+    framework: framework(options.framework),
+    build: {
+      contentVersion: options.contentVersion ?? "local",
+      buildId: options.buildId ?? "local",
+    },
+    capabilities,
+    warnings,
+  });
+  await writeJson(path.join(root, "routes.json"), routes);
+  await writeJson(path.join(root, "middleware.json"), middleware);
+  await writeJson(path.join(root, "artifacts.json"), { artifacts });
+  await writeJson(path.join(root, "features.json"), { features: [] });
+  await writeJson(path.join(root, "observability.json"), {
+    adapter: ADAPTER_PACKAGE,
+    framework: options.framework?.name ?? "generic",
+    buildId: options.buildId ?? "local",
+  });
+
+  await options.afterEmit?.(generated);
+
+  return generated;
+}

package/src/index.ts

@@ -0,0 +1,25 @@
+export { buildGenericOutput, loadConfig } from "./config.js";
+export { emitGenericUnioOutput } from "./emit.js";
+export type {
+  BuildGenericOutputOptions,
+  EmitGenericUnioOutputOptions,
+  GeneratedGenericUboa,
+  GenericArtifact,
+  GenericArtifactResourceKind,
+  GenericAssetsRoute,
+  GenericBuildConfig,
+  GenericConfig,
+  GenericCapabilities,
+  GenericEdgeBundleConfig,
+  GenericEdgeBundleDescriptor,
+  GenericEdgeFunctionRoute,
+  GenericEdgeMiddleware,
+  GenericFrameworkConfig,
+  GenericMiddleware,
+  GenericRoute,
+  GenericServerFunctionConfig,
+  GenericServerFunctionDescriptor,
+  GenericServerFunctionRoute,
+  GenericServerlessMiddleware,
+  LoadGenericConfigOptions,
+} from "./types.js";

package/src/types.ts

@@ -0,0 +1,182 @@
+export type CapabilityStatus =
+  | "supported"
+  | "partial"
+  | "degraded"
+  | "unsupported";
+
+export interface GenericCapabilities {
+  static: CapabilityStatus;
+  routes: CapabilityStatus;
+  serverlessFunction: CapabilityStatus;
+  serverFunctionIntrospection: CapabilityStatus;
+  restRouteIntrospection: CapabilityStatus;
+  edgeMiddleware: CapabilityStatus;
+  imageOptimization: CapabilityStatus;
+}
+
+export interface GenericBuildConfig {
+  command?: string;
+  staticDir?: string;
+}
+
+export interface GenericFrameworkConfig {
+  name?: string;
+  version?: string;
+}
+
+export interface GenericServerFunctionConfig {
+  name: string;
+  sourceDir: string;
+  entry: string;
+  handler?: string;
+  runtime?: string;
+  memory?: number;
+  maxDuration?: number;
+  environment?: Record<string, unknown>;
+  bindings?: Record<string, unknown>;
+}
+
+export interface GenericEdgeBundleConfig {
+  name: string;
+  sourceDir: string;
+  entry: string;
+  handler?: string;
+  runtime?: string;
+  bindings?: Record<string, unknown>;
+}
+
+interface GenericRouteBase {
+  id: string;
+  match: string;
+}
+
+export interface GenericAssetsRoute extends GenericRouteBase {
+  type: "assets";
+  entry: string;
+  serverFunction?: never;
+  edgeFunction?: never;
+  methods?: never;
+}
+
+export interface GenericServerFunctionRoute extends GenericRouteBase {
+  type: "serverFunction";
+  serverFunction: string;
+  methods?: string[];
+  entry?: never;
+  edgeFunction?: never;
+}
+
+export interface GenericEdgeFunctionRoute extends GenericRouteBase {
+  type: "edgeFunction";
+  edgeFunction: string;
+  entry?: never;
+  serverFunction?: never;
+  methods?: never;
+}
+
+export type GenericRoute =
+  | GenericAssetsRoute
+  | GenericServerFunctionRoute
+  | GenericEdgeFunctionRoute;
+
+interface GenericMiddlewareBase {
+  name: string;
+  match: string[];
+}
+
+export interface GenericEdgeMiddleware extends GenericMiddlewareBase {
+  runtime: "edge";
+  entry: string;
+  serverFunction?: never;
+}
+
+export interface GenericServerlessMiddleware extends GenericMiddlewareBase {
+  runtime: "serverless";
+  serverFunction: string;
+  entry?: never;
+}
+
+export type GenericMiddleware =
+  | GenericEdgeMiddleware
+  | GenericServerlessMiddleware;
+
+export type GenericArtifactResourceKind =
+  | "assets"
+  | "serverFunction"
+  | "edge"
+  | "apiSchema";
+
+export interface GenericArtifact {
+  id: string;
+  resourceKind: GenericArtifactResourceKind;
+  path: string;
+  schemaFormat?: "oneapi";
+  describes?: {
+    resourceKind?: GenericArtifactResourceKind;
+    id?: string;
+  };
+}
+
+export interface GenericServerFunctionDescriptor {
+  name: string;
+  runtime: string;
+  entry: string;
+  handler: string;
+  handlerProtocol: "nodejs";
+  memory: number;
+  maxDuration: number;
+  environment: Record<string, unknown>;
+  bindings: Record<string, unknown>;
+  framework: Record<string, unknown>;
+  source: Record<string, unknown>;
+  deployment: {
+    mode: "shared";
+    functionAppName: "unistackfaasruntime";
+  };
+  [key: string]: unknown;
+}
+
+export interface GenericEdgeBundleDescriptor {
+  name: string;
+  runtime: string;
+  entry: string;
+  handler: string;
+  handlerProtocol: "fetch";
+  bindings: Record<string, unknown>;
+  framework: Record<string, unknown>;
+  source: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
+export interface GeneratedGenericUboa {
+  outputDir: string;
+  routes: GenericRoute[];
+  middleware: GenericMiddleware[];
+  artifacts: GenericArtifact[];
+  capabilities: GenericCapabilities;
+  warnings: string[];
+}
+
+export interface EmitGenericUnioOutputOptions {
+  cwd?: string;
+  outputDir?: string;
+  build?: GenericBuildConfig;
+  framework?: GenericFrameworkConfig;
+  buildId?: string;
+  contentVersion?: string;
+  serverFunctions?: GenericServerFunctionConfig[];
+  edgeBundles?: GenericEdgeBundleConfig[];
+  routes?: GenericRoute[];
+  middleware?: GenericMiddleware[];
+  afterEmit?: (result: GeneratedGenericUboa) => void | Promise<void>;
+}
+
+export interface GenericConfig extends EmitGenericUnioOutputOptions {}
+
+export interface LoadGenericConfigOptions {
+  projectDir: string;
+  configPath: string;
+  outputDir?: string;
+}
+
+export interface BuildGenericOutputOptions extends LoadGenericConfigOptions {}