import * as Namespace from "alchemy/Namespace";
import { resolveAstroOutput } from "alchemy/Website/AstroOutput";
import * as Effect from "effect/Effect";
import {
makeFrameworkSite,
staticConfigFromAssets,
type FrameworkSiteProps,
} from "./FrameworkSite.ts";
/** The framework-integration package that drives the Astro build. */
export const ASTRO_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/astro";
/** The Node container deploy target for the Astro build. */
export const ASTRO_NODE_TARGET_SPECIFIER = "@alchemy.run/frontend-frameworks/astro/node";
export interface AstroProps extends FrameworkSiteProps {
/**
* Serializable Astro config merged OVER the project's own
* `astro.config.*` (which loads natively). `adapter` is owned by the Node
* deploy target and may not be set here.
*/
astro?: {
/** The full URL the site deploys to (`Astro.site`). */
site?: string;
/** Base path the site deploys under. */
base?: string;
/**
* Astro output target. `"server"` renders pages on demand in the
* container; individual pages opt into prerendering with
* `export const prerender = true`. `"static"` prerenders every page at
* build time and deploys assets-only (no framework handler). Overrides
* the `output` in your `astro.config.*`; leave it unset to use the
* file's value.
* @default the config file's `output`, else `"server"`
*/
output?: "server" | "static";
/** Source directory, relative to `rootDir`. @default "./src" */
srcDir?: string;
/** Public (static passthrough) directory. @default "./public" */
publicDir?: string;
/** Build output directory. @default "./dist" */
outDir?: string;
/** Trailing-slash handling for routes. */
trailingSlash?: "always" | "never" | "ignore";
};
}
/**
* Deploy an [Astro](https://astro.build) application to Railway: the Node
* SSR bundle (assets first, then the Astro fetch handler) on one
* `Railway.Service`. Pages render on demand by default
* (`output: "server"`); pages that `export const prerender = true` are
* prerendered at build time and served as static files. When your
* `astro.config.*` or `astro: { output: "static" }` declares a static
* site, every page is prerendered and the deploy is assets-only.
*
* The build runs through `@alchemy.run/frontend-frameworks/astro` with the
* `@alchemy.run/frontend-frameworks/astro/node` deploy target (a Node
* adapter is injected — your `astro.config.*` must not declare one).
*
* During `alchemy dev` the site is Astro's own dev server and no cloud
* resources are created. `Alchemy.remote()` opts back into the live
* Service path.
*
* ### Creating Astro Sites
* **Example:** Basic Astro App
* ```typescript
* const site = yield* Railway.Website.Astro("Web", {
* rootDir: "./app",
* });
* ```
*
* ### Static Sites
* **Example:** Fully Static Astro Site
* ```typescript
* const site = yield* Railway.Website.Astro("Docs", {
* rootDir: "./docs",
* astro: { output: "static" },
* errorPage: "404.html",
* });
* ```
*
* ### Server Configuration
* **Example:** Process Environment
* ```typescript
* const site = yield* Railway.Website.Astro("Web", {
* rootDir: "./app",
* env: {
* API_BASE: "https://api.example.com",
* },
* });
* ```
*
* @resource
* @product Website
*/
export const Astro = (id: string, props: AstroProps = {}) =>
resolveAstroOutput({ rootDir: props.rootDir, output: props.astro?.output }).pipe(
Effect.flatMap((output) =>
makeFrameworkSite(id, props, {
name: "Astro",
framework: ASTRO_FRAMEWORK_SPECIFIER,
target: ASTRO_NODE_TARGET_SPECIFIER,
options: { astro: { ...props.astro, output } },
static: output === "static" ? staticConfigFromAssets(props.assets) : undefined,
}),
),
Namespace.push(id),
);