import type { InputProps } from "alchemy/Input";
import * as Namespace from "alchemy/Namespace";
import { makeFrameworkSite, type FrameworkSiteProps } from "./FrameworkSite.ts";
/** The framework-integration package that drives the Waku build. */
export const WAKU_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/waku";
/** The AWS Lambda deploy target for the Waku build. */
export const WAKU_AWS_TARGET_SPECIFIER = "@alchemy.run/frontend-frameworks/waku/aws";
/** The Node deploy target for the Lambda Web Function server (the default). */
export const WAKU_WEB_TARGET_SPECIFIER = "@alchemy.run/frontend-frameworks/waku/node";
export type WakuProps = FrameworkSiteProps<{
/**
* Waku config overrides merged over the project's `waku.config.*`
* (per-key; deploy-time values win). For values that vary by stage or
* come from other resources — static config belongs in `waku.config.*`.
*/
waku?: {
/**
* Waku `srcDir` (relative to {@link FrameworkSiteProps.rootDir}).
* @default "src"
*/
srcDir?: string;
/**
* Waku `distDir` (relative to {@link FrameworkSiteProps.rootDir}).
* A custom `distDir` must be gitignored (or added to `memo.exclude`)
* so the build output stays excluded from the rebuild-deciding input
* hash.
* @default "dist"
*/
distDir?: string;
/**
* Waku `basePath`.
* @default "/"
*/
basePath?: string;
};
}>;
/**
* Deploy a [Waku](https://waku.gg) application to AWS: the RSC server on a
* Lambda Web Function, static assets (SSG pages included) in S3, and a
* CloudFront distribution whose edge router serves uploaded files from S3
* and forwards everything else to the server.
*
* The server runs on a Lambda Web Function: the framework's Node server
* (built with the `@alchemy.run/frontend-frameworks/waku/node` deploy
* target) serves many requests per environment and streams responses. Set
* `server: "function"` to use a Lambda Function behind a streaming Function
* URL instead, built with the `/aws` target below, for Regions without Web
* Functions.
*
* The build runs through `@alchemy.run/frontend-frameworks/waku` with the
* `@alchemy.run/frontend-frameworks/waku/aws` deploy target (this package's fork
* of waku's aws-lambda adapter, streaming enabled) — both must be installed
* in your project.
*
* ### Creating Waku Sites
* **Example:** Basic Waku App
* ```typescript
* const site = yield* AWS.Website.Waku("Web", {
* rootDir: "./app",
* });
* ```
*
* **Example:** Custom Domain
* ```typescript
* const site = yield* AWS.Website.Waku("Web", {
* rootDir: "./app",
* domain: {
* name: "app.example.com",
* hostedZoneId: zone.hostedZoneId,
* },
* });
* ```
*
* ### Server Configuration
* **Example:** Tune The Server Function
* ```typescript
* const site = yield* AWS.Website.Waku("Web", {
* rootDir: "./app",
* memorySize: 2048,
* env: {
* API_BASE: api.url,
* },
* });
* ```
*
* ### Waku Config Overrides
* Waku configuration lives in your `waku.config.*`. The `waku` prop
* overrides it per key at deploy time — for values that vary by stage
* or come from other resources.
*
* **Example:** Stage-dependent base path
* ```typescript
* const site = yield* AWS.Website.Waku("Web", {
* waku: {
* basePath: "/docs/",
* },
* });
* ```
*
* @resource
*/
export const Waku = (id: string, props: InputProps<WakuProps, "server"> = {}) => {
const p = props as WakuProps;
return makeFrameworkSite(id, props, {
name: "Waku",
framework: WAKU_FRAMEWORK_SPECIFIER,
target: WAKU_AWS_TARGET_SPECIFIER,
webTarget: WAKU_WEB_TARGET_SPECIFIER,
// Deploy-time waku config overrides, merged over the project's
// `waku.config.*` by the integration (per-key; overrides win).
options: p.waku !== undefined ? { waku: p.waku } : undefined,
}).pipe(Namespace.push(id));
};