@alchemy.run/fly 0.0.0 → 2.0.0-beta.84

package/lib/Website/ReactRouter.d.ts

@@ -0,0 +1,80 @@
+import { type FrameworkSiteProps } from "./FrameworkSite.ts";
+/** The framework-integration package that drives the React Router build. */
+export declare const REACT_ROUTER_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/react-router";
+/** The Node container deploy target for the React Router build. */
+export declare const REACT_ROUTER_NODE_TARGET_SPECIFIER = "@alchemy.run/frontend-frameworks/react-router/node";
+export interface ReactRouterProps extends FrameworkSiteProps {
+}
+/**
+ * Deploy a [React Router](https://reactrouter.com) v7 app (framework mode)
+ * to Fly: the SSR server on a Machine, static assets baked into the image,
+ * served assets-first then the framework handler.
+ *
+ * The build runs through
+ * `@alchemy.run/frontend-frameworks/react-router` with the
+ * `@alchemy.run/frontend-frameworks/react-router/node` deploy target — both
+ * must be installed in your project, alongside `@react-router/dev`,
+ * `react-router`, and `vite`.
+ *
+ * Your `vite.config.ts` needs no adapter wiring. React Router's server
+ * build is a `ServerBuild` manifest rather than a request handler, so the
+ * integration wraps the manifest with `createRequestHandler` and packages
+ * the resulting fetch handler as a Node HTTP server on port 3000.
+ *
+ * React Server Components (React Router's `unstable` RSC plugin) and
+ * multi-environment builds are not supported yet — the build fails with an
+ * actionable error when more than one server entry is emitted.
+ *
+ *
+ * ### Creating React Router Sites
+ * **Example:** Basic React Router App
+ * ```typescript
+ * const site = yield* Fly.Website.ReactRouter("Web", {
+ *   rootDir: "./app",
+ * });
+ * ```
+ *
+ * **Example:** Custom Domain
+ * ```typescript
+ * const site = yield* Fly.Website.ReactRouter("Web", {
+ *   rootDir: "./app",
+ *   domain: "app.example.com",
+ * });
+ * ```
+ *
+ * ### Server Configuration
+ * **Example:** Process Environment
+ * ```typescript
+ * const site = yield* Fly.Website.ReactRouter("Web", {
+ *   rootDir: "./app",
+ *   env: {
+ *     GREETING: "Hello from React Router on Fly!",
+ *   },
+ * });
+ * ```
+ *
+ * **Example:** Read An Environment Variable From A Loader
+ * ```typescript
+ * // app/routes/home.tsx
+ * export function loader() {
+ *   return { greeting: process.env.GREETING ?? "Hello!" };
+ * }
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export declare const ReactRouter: (id: string, props?: ReactRouterProps) => import("effect/Effect").Effect<{
+    url: import("alchemy/Output").Output<string | undefined, never>;
+    app: undefined;
+    service: undefined;
+    ip: undefined;
+    certificate: undefined;
+} | {
+    url: string | import("alchemy/Output").Output<string, never>;
+    app: import("../App.ts").App;
+    service: import("../Service.ts").Service;
+    ip: import("../IpAssignment.ts").IpAssignment;
+    certificate: import("../Certificate.ts").Certificate | undefined;
+}, never, import("alchemy/AlchemyContext").AlchemyContext | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("alchemy/Provider").Provider<import("alchemy/Website/Server").Server> | import("../Providers.ts").Providers>;
+//# sourceMappingURL=ReactRouter.d.ts.map

package/lib/Website/ReactRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactRouter.d.ts","sourceRoot":"","sources":["../../src/Website/ReactRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,4EAA4E;AAC5E,eAAO,MAAM,gCAAgC,kDAAkD,CAAC;AAEhG,mEAAmE;AACnE,eAAO,MAAM,kCAAkC,uDACO,CAAC;AAEvD,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;CAAG;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,WAAW,OAAQ,MAAM,UAAS,gBAAgB;;;;;;;;;;;;qPAK3D,CAAC"}

package/lib/Website/ReactRouter.js

@@ -0,0 +1,70 @@
+import { frameworkSite } from "./FrameworkSite.js";
+/** The framework-integration package that drives the React Router build. */
+export const REACT_ROUTER_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/react-router";
+/** The Node container deploy target for the React Router build. */
+export const REACT_ROUTER_NODE_TARGET_SPECIFIER = "@alchemy.run/frontend-frameworks/react-router/node";
+/**
+ * Deploy a [React Router](https://reactrouter.com) v7 app (framework mode)
+ * to Fly: the SSR server on a Machine, static assets baked into the image,
+ * served assets-first then the framework handler.
+ *
+ * The build runs through
+ * `@alchemy.run/frontend-frameworks/react-router` with the
+ * `@alchemy.run/frontend-frameworks/react-router/node` deploy target — both
+ * must be installed in your project, alongside `@react-router/dev`,
+ * `react-router`, and `vite`.
+ *
+ * Your `vite.config.ts` needs no adapter wiring. React Router's server
+ * build is a `ServerBuild` manifest rather than a request handler, so the
+ * integration wraps the manifest with `createRequestHandler` and packages
+ * the resulting fetch handler as a Node HTTP server on port 3000.
+ *
+ * React Server Components (React Router's `unstable` RSC plugin) and
+ * multi-environment builds are not supported yet — the build fails with an
+ * actionable error when more than one server entry is emitted.
+ *
+ *
+ * ### Creating React Router Sites
+ * **Example:** Basic React Router App
+ * ```typescript
+ * const site = yield* Fly.Website.ReactRouter("Web", {
+ *   rootDir: "./app",
+ * });
+ * ```
+ *
+ * **Example:** Custom Domain
+ * ```typescript
+ * const site = yield* Fly.Website.ReactRouter("Web", {
+ *   rootDir: "./app",
+ *   domain: "app.example.com",
+ * });
+ * ```
+ *
+ * ### Server Configuration
+ * **Example:** Process Environment
+ * ```typescript
+ * const site = yield* Fly.Website.ReactRouter("Web", {
+ *   rootDir: "./app",
+ *   env: {
+ *     GREETING: "Hello from React Router on Fly!",
+ *   },
+ * });
+ * ```
+ *
+ * **Example:** Read An Environment Variable From A Loader
+ * ```typescript
+ * // app/routes/home.tsx
+ * export function loader() {
+ *   return { greeting: process.env.GREETING ?? "Hello!" };
+ * }
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export const ReactRouter = (id, props = {}) => frameworkSite(id, props, {
+    name: "ReactRouter",
+    framework: REACT_ROUTER_FRAMEWORK_SPECIFIER,
+    target: REACT_ROUTER_NODE_TARGET_SPECIFIER,
+});
+//# sourceMappingURL=ReactRouter.js.map

package/lib/Website/ReactRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactRouter.js","sourceRoot":"","sources":["../../src/Website/ReactRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAE5E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gCAAgC,GAAG,+CAA+C,CAAC;AAEhG,mEAAmE;AACnE,MAAM,CAAC,MAAM,kCAAkC,GAC7C,oDAAoD,CAAC;AAIvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,KAAK,GAAqB,EAAE,EAAE,EAAE,CACtE,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE;IACvB,IAAI,EAAE,aAAa;IACnB,SAAS,EAAE,gCAAgC;IAC3C,MAAM,EAAE,kCAAkC;CAC3C,CAAC,CAAC"}

package/lib/Website/SolidStart.d.ts

@@ -0,0 +1,93 @@
+import { type FrameworkSiteProps } from "./FrameworkSite.ts";
+/** The framework-integration package that drives the SolidStart build. */
+export declare const SOLIDSTART_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/solidstart";
+/** The Node container deploy target for the SolidStart build. */
+export declare const SOLIDSTART_NODE_TARGET_SPECIFIER = "@alchemy.run/frontend-frameworks/solidstart/node";
+export interface SolidStartProps extends FrameworkSiteProps {
+    /**
+     * Nitro options forwarded into the nitro plugin the integration appends
+     * (prerendering, route rules, storage, ...). `preset` is owned by the
+     * Node deploy target and may not be set here. JSON-serializable values
+     * only — no functions or plugin instances.
+     *
+     * This is a prop (rather than project config) because the integration
+     * owns the nitro plugin instance: a `nitroV2Plugin()` in your project's
+     * `vite.config.*` is rejected, so this prop is the one home for nitro
+     * options — and it accepts values derived from other resources' Outputs,
+     * which a config file cannot.
+     */
+    nitro?: Record<string, unknown>;
+}
+/**
+ * Deploy a [SolidStart](https://start.solidjs.com) application to Fly: the
+ * SSR server on a Machine, static assets (prerendered pages included)
+ * baked into the image, served assets-first then the framework handler.
+ *
+ * The build runs through `@alchemy.run/frontend-frameworks/solidstart` with
+ * the `@alchemy.run/frontend-frameworks/solidstart/node` deploy target —
+ * both must be installed in your project, alongside `@solidjs/start` and
+ * `@solidjs/vite-plugin-nitro-2`.
+ *
+ * Your `vite.config.ts` needs no adapter wiring: the integration drives the
+ * project's own `vite build` and appends its own nitro plugin instance
+ * carrying nitro's `node` preset.
+ *
+ *
+ * ### Creating SolidStart Sites
+ * **Example:** Basic SolidStart App
+ * ```typescript
+ * const site = yield* Fly.Website.SolidStart("Web", {
+ *   rootDir: "./app",
+ * });
+ * ```
+ *
+ * **Example:** Custom Domain
+ * ```typescript
+ * const site = yield* Fly.Website.SolidStart("Web", {
+ *   rootDir: "./app",
+ *   domain: "app.example.com",
+ * });
+ * ```
+ *
+ * ### Server Configuration
+ * **Example:** Process Environment
+ * ```typescript
+ * const site = yield* Fly.Website.SolidStart("Web", {
+ *   rootDir: "./app",
+ *   env: {
+ *     GREETING: "Hello from SolidStart on Fly!",
+ *   },
+ * });
+ * ```
+ *
+ * ### Prerendering
+ * The integration owns the nitro plugin instance (a `nitroV2Plugin()` in
+ * your `vite.config.*` is rejected), so nitro options — prerendering
+ * included — go on the `nitro` prop. Prerendered pages are baked into the
+ * image and served as static files.
+ *
+ * **Example:** Prerender Routes
+ * ```typescript
+ * const site = yield* Fly.Website.SolidStart("Web", {
+ *   rootDir: "./app",
+ *   nitro: { prerender: { routes: ["/", "/about"] } },
+ * });
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export declare const SolidStart: (id: string, props?: SolidStartProps) => import("effect/Effect").Effect<{
+    url: import("alchemy/Output").Output<string | undefined, never>;
+    app: undefined;
+    service: undefined;
+    ip: undefined;
+    certificate: undefined;
+} | {
+    url: string | import("alchemy/Output").Output<string, never>;
+    app: import("../App.ts").App;
+    service: import("../Service.ts").Service;
+    ip: import("../IpAssignment.ts").IpAssignment;
+    certificate: import("../Certificate.ts").Certificate | undefined;
+}, never, import("alchemy/AlchemyContext").AlchemyContext | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("alchemy/Provider").Provider<import("alchemy/Website/Server").Server> | import("../Providers.ts").Providers>;
+//# sourceMappingURL=SolidStart.d.ts.map

package/lib/Website/SolidStart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidStart.d.ts","sourceRoot":"","sources":["../../src/Website/SolidStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,0EAA0E;AAC1E,eAAO,MAAM,8BAA8B,gDAAgD,CAAC;AAE5F,iEAAiE;AACjE,eAAO,MAAM,gCAAgC,qDAAqD,CAAC;AAEnG,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,UAAU,OAAQ,MAAM,UAAS,eAAe;;;;;;;;;;;;qPAMzD,CAAC"}

package/lib/Website/SolidStart.js

@@ -0,0 +1,71 @@
+import { frameworkSite } from "./FrameworkSite.js";
+/** The framework-integration package that drives the SolidStart build. */
+export const SOLIDSTART_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/solidstart";
+/** The Node container deploy target for the SolidStart build. */
+export const SOLIDSTART_NODE_TARGET_SPECIFIER = "@alchemy.run/frontend-frameworks/solidstart/node";
+/**
+ * Deploy a [SolidStart](https://start.solidjs.com) application to Fly: the
+ * SSR server on a Machine, static assets (prerendered pages included)
+ * baked into the image, served assets-first then the framework handler.
+ *
+ * The build runs through `@alchemy.run/frontend-frameworks/solidstart` with
+ * the `@alchemy.run/frontend-frameworks/solidstart/node` deploy target —
+ * both must be installed in your project, alongside `@solidjs/start` and
+ * `@solidjs/vite-plugin-nitro-2`.
+ *
+ * Your `vite.config.ts` needs no adapter wiring: the integration drives the
+ * project's own `vite build` and appends its own nitro plugin instance
+ * carrying nitro's `node` preset.
+ *
+ *
+ * ### Creating SolidStart Sites
+ * **Example:** Basic SolidStart App
+ * ```typescript
+ * const site = yield* Fly.Website.SolidStart("Web", {
+ *   rootDir: "./app",
+ * });
+ * ```
+ *
+ * **Example:** Custom Domain
+ * ```typescript
+ * const site = yield* Fly.Website.SolidStart("Web", {
+ *   rootDir: "./app",
+ *   domain: "app.example.com",
+ * });
+ * ```
+ *
+ * ### Server Configuration
+ * **Example:** Process Environment
+ * ```typescript
+ * const site = yield* Fly.Website.SolidStart("Web", {
+ *   rootDir: "./app",
+ *   env: {
+ *     GREETING: "Hello from SolidStart on Fly!",
+ *   },
+ * });
+ * ```
+ *
+ * ### Prerendering
+ * The integration owns the nitro plugin instance (a `nitroV2Plugin()` in
+ * your `vite.config.*` is rejected), so nitro options — prerendering
+ * included — go on the `nitro` prop. Prerendered pages are baked into the
+ * image and served as static files.
+ *
+ * **Example:** Prerender Routes
+ * ```typescript
+ * const site = yield* Fly.Website.SolidStart("Web", {
+ *   rootDir: "./app",
+ *   nitro: { prerender: { routes: ["/", "/about"] } },
+ * });
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export const SolidStart = (id, props = {}) => frameworkSite(id, props, {
+    name: "SolidStart",
+    framework: SOLIDSTART_FRAMEWORK_SPECIFIER,
+    target: SOLIDSTART_NODE_TARGET_SPECIFIER,
+    options: { nitro: props.nitro },
+});
+//# sourceMappingURL=SolidStart.js.map

package/lib/Website/SolidStart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidStart.js","sourceRoot":"","sources":["../../src/Website/SolidStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAE5E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,8BAA8B,GAAG,6CAA6C,CAAC;AAE5F,iEAAiE;AACjE,MAAM,CAAC,MAAM,gCAAgC,GAAG,kDAAkD,CAAC;AAkBnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAU,EAAE,KAAK,GAAoB,EAAE,EAAE,EAAE,CACpE,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE;IACvB,IAAI,EAAE,YAAY;IAClB,SAAS,EAAE,8BAA8B;IACzC,MAAM,EAAE,gCAAgC;IACxC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;CAChC,CAAC,CAAC"}

package/lib/Website/StaticSite.d.ts

@@ -0,0 +1,155 @@
+import { AlchemyContext } from "alchemy/AlchemyContext";
+import * as Command from "alchemy/Command";
+import type { MemoOptions } from "alchemy/Command/Memo";
+import * as Output from "alchemy/Output";
+import * as Effect from "effect/Effect";
+import * as Path from "effect/Path";
+import type * as Redacted from "effect/Redacted";
+import { App } from "../App.ts";
+import { Certificate } from "../Certificate.ts";
+import { IpAssignment } from "../IpAssignment.ts";
+import { Service, type ServiceProps } from "../Service.ts";
+import { type Ref, type WebsiteAssetsProps } from "./FrameworkSite.ts";
+export interface StaticSiteProps {
+    /** Deployment strategy forwarded to the hosted Fly Service. */
+    deploy?: ServiceProps["deploy"];
+    /** Process shutdown policy for the generated server. */
+    shutdown?: ServiceProps["shutdown"];
+    /** Named Machine readiness checks. */
+    checks?: ServiceProps["checks"];
+    /** Override proxy services and their routing health checks. */
+    services?: ServiceProps["services"];
+    /**
+     * Path to the local site directory (working directory for
+     * {@link build.command}).
+     * @default "."
+     */
+    path?: string;
+    /**
+     * Build executed before deploy.
+     */
+    build: {
+        /** Shell command that produces the site (e.g. `"hugo --minify"`). */
+        command: string;
+        /** Directory the command writes, relative to {@link path}. */
+        output: string;
+        /** Environment variables for the build command. */
+        env?: Record<string, string | Redacted.Redacted<string>>;
+    };
+    /**
+     * Controls which files are hashed to decide whether the build re-runs.
+     * @default true
+     */
+    memo?: MemoOptions | boolean;
+    /**
+     * Process environment for the hosted static server.
+     */
+    env?: Record<string, string | Redacted.Redacted<string>>;
+    /**
+     * Miss handling for the generated file server.
+     */
+    assets?: WebsiteAssetsProps;
+    /**
+     * Parent Fly App. When omitted, a `Fly.App` is created. The Service
+     * stays in the caller namespace; only `Build` / `Dev` are pushed.
+     */
+    app?: Ref<App>;
+    /**
+     * Optional custom hostname. Requests ACME (`Fly.Certificate`) on the App.
+     */
+    domain?: string;
+    /**
+     * User-defined tags. Accepted for API parity; Fly Services do not
+     * surface resource tags.
+     */
+    tags?: Record<string, string>;
+    /**
+     * Local dev configuration. When `alchemy dev` runs with `dev.command`,
+     * the build is skipped and `command` is spawned as a long-lived child.
+     */
+    dev?: {
+        /**
+         * Shell command to run as the local dev server (e.g. `npm run dev`).
+         */
+        command: string;
+        /**
+         * Working directory for {@link command}. Defaults to {@link cwd}.
+         */
+        cwd?: string;
+        /**
+         * Environment variables for {@link command}.
+         */
+        env?: Record<string, string | Redacted.Redacted<string>>;
+        /**
+         * Override for the `url` output if alchemy fails to detect it from
+         * stdout of the dev command.
+         */
+        url?: string;
+    };
+}
+/**
+ * Deploy a static site built by a shell command to Fly.
+ *
+ * `StaticSite` runs a build command (e.g. `npm run build` / `hugo`),
+ * content-hashes the output directory, and deploys a Service that serves
+ * those files (plus `/health`). Use this when the site has its own build
+ * step — Hugo, Zola, Eleventy, or any custom pipeline.
+ *
+ * For Vite-based projects, prefer `Fly.Website.Vite`.
+ *
+ * `Build` / `Dev` use constant logical ids under `Namespace.push(id)`.
+ * The Service stays in the caller namespace (same as
+ * `Cloudflare.Website.StaticSite`).
+ *
+ *
+ * ### Basic Usage
+ * **Example:** Deploying a Hugo site
+ * ```typescript
+ * const site = yield* Fly.Website.StaticSite("Blog", {
+ *   build: { command: "hugo --minify", output: "public" },
+ * });
+ * ```
+ *
+ * **Example:** SPA-style routing
+ * ```typescript
+ * const site = yield* Fly.Website.StaticSite("App", {
+ *   build: { command: "npm run build", output: "dist" },
+ *   assets: { notFoundHandling: "single-page-application" },
+ * });
+ * ```
+ *
+ * ### Building from a Subdirectory
+ * **Example:** Building a frontend in a monorepo
+ * ```typescript
+ * const site = yield* Fly.Website.StaticSite("Web", {
+ *   path: "apps/web",
+ *   build: { command: "npm run build", output: "dist" },
+ * });
+ * ```
+ *
+ * ### Local Development
+ * **Example:** External dev command
+ * ```typescript
+ * const site = yield* Fly.Website.StaticSite("App", {
+ *   build: { command: "npm run build", output: "dist" },
+ *   dev: { command: "npm run dev" },
+ * });
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export declare const StaticSite: (id: string, props: StaticSiteProps) => Effect.Effect<{
+    app: App | undefined;
+    service: Service | undefined;
+    ip: IpAssignment | undefined;
+    certificate: Certificate | undefined;
+    url: Output.Output<string | undefined, never>;
+} | {
+    url: string | Output.Output<string, never>;
+    app: App;
+    service: Service;
+    ip: IpAssignment;
+    certificate: Certificate | undefined;
+}, never, AlchemyContext | import("effect/FileSystem").FileSystem | Path.Path | import("alchemy/Provider").Provider<Command.Build> | import("alchemy/Provider").Provider<Command.Dev> | import("../Providers.ts").Providers>;
+//# sourceMappingURL=StaticSite.d.ts.map

package/lib/Website/StaticSite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StaticSite.d.ts","sourceRoot":"","sources":["../../src/Website/StaticSite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAIzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAEL,KAAK,GAAG,EACR,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC,sCAAsC;IACtC,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE;QACL,qEAAqE;QACrE,OAAO,EAAE,MAAM,CAAC;QAChB,8DAA8D;QAC9D,MAAM,EAAE,MAAM,CAAC;QACf,mDAAmD;QACnD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;KAC1D,CAAC;IACF;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IAC7B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B;;;OAGG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B;;;OAGG;IACH,GAAG,CAAC,EAAE;QACJ;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QACb;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD;;;WAGG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,UAAU,OAAQ,MAAM,SAAS,eAAe;;;;;;;;;;;;4NAsHtC,CAAC"}

package/lib/Website/StaticSite.js

@@ -0,0 +1,168 @@
+import { AlchemyContext } from "alchemy/AlchemyContext";
+import * as Command from "alchemy/Command";
+import * as Namespace from "alchemy/Namespace";
+import * as Output from "alchemy/Output";
+import { ProviderModePolicy } from "alchemy/ProviderMode";
+import { initialCwd } from "alchemy/Util/Node";
+import { loadFrontendCore } from "alchemy/Website/FrontendCore";
+import * as Effect from "effect/Effect";
+import * as Path from "effect/Path";
+import { App } from "../App.js";
+import { Certificate } from "../Certificate.js";
+import { IpAssignment } from "../IpAssignment.js";
+import { Service } from "../Service.js";
+import { staticConfigFromAssets, } from "./FrameworkSite.js";
+const DEFAULT_PORT = 3000;
+const resolveRef = (ref) => (Effect.isEffect(ref) ? ref : Effect.succeed(ref));
+/**
+ * Deploy a static site built by a shell command to Fly.
+ *
+ * `StaticSite` runs a build command (e.g. `npm run build` / `hugo`),
+ * content-hashes the output directory, and deploys a Service that serves
+ * those files (plus `/health`). Use this when the site has its own build
+ * step — Hugo, Zola, Eleventy, or any custom pipeline.
+ *
+ * For Vite-based projects, prefer `Fly.Website.Vite`.
+ *
+ * `Build` / `Dev` use constant logical ids under `Namespace.push(id)`.
+ * The Service stays in the caller namespace (same as
+ * `Cloudflare.Website.StaticSite`).
+ *
+ *
+ * ### Basic Usage
+ * **Example:** Deploying a Hugo site
+ * ```typescript
+ * const site = yield* Fly.Website.StaticSite("Blog", {
+ *   build: { command: "hugo --minify", output: "public" },
+ * });
+ * ```
+ *
+ * **Example:** SPA-style routing
+ * ```typescript
+ * const site = yield* Fly.Website.StaticSite("App", {
+ *   build: { command: "npm run build", output: "dist" },
+ *   assets: { notFoundHandling: "single-page-application" },
+ * });
+ * ```
+ *
+ * ### Building from a Subdirectory
+ * **Example:** Building a frontend in a monorepo
+ * ```typescript
+ * const site = yield* Fly.Website.StaticSite("Web", {
+ *   path: "apps/web",
+ *   build: { command: "npm run build", output: "dist" },
+ * });
+ * ```
+ *
+ * ### Local Development
+ * **Example:** External dev command
+ * ```typescript
+ * const site = yield* Fly.Website.StaticSite("App", {
+ *   build: { command: "npm run build", output: "dist" },
+ *   dev: { command: "npm run dev" },
+ * });
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export const StaticSite = (id, props) => Effect.gen(function* () {
+    const ctx = yield* AlchemyContext;
+    const remoted = yield* ProviderModePolicy;
+    const isLocal = ctx.dev && remoted !== true;
+    const path = yield* Path.Path;
+    const empty = () => ({
+        url: undefined,
+        app: undefined,
+        service: undefined,
+        ip: undefined,
+        certificate: undefined,
+    });
+    if (isLocal && props.dev) {
+        const dev = yield* Command.Dev("Dev", {
+            command: props.dev.command,
+            cwd: props.dev.cwd ?? props.path,
+            env: props.dev.env ?? props.env,
+        }).pipe(Namespace.push(id));
+        const url = Output.map(dev.url, (value) => value ?? props.dev?.url);
+        return { ...empty(), url };
+    }
+    const build = yield* Command.Build("Build", {
+        command: props.build.command,
+        cwd: props.path,
+        memo: props.memo,
+        outdir: props.build.output,
+        env: props.build.env ?? props.env,
+    }).pipe(Namespace.push(id));
+    const cwd = path.resolve(initialCwd, props.path ?? ".");
+    const outdir = path.resolve(cwd, props.build.output);
+    const internal = staticConfigFromAssets(props.assets);
+    const notFoundHandling = internal.errorPage !== undefined
+        ? "404-page"
+        : internal.spa === true
+            ? "spa"
+            : "none";
+    const { NODE_SERVE_ENTRY_FILE_NAME, relativeClientDirExpression, writeNodeServeEntry } = yield* loadFrontendCore;
+    const servePath = path.join(path.dirname(outdir), NODE_SERVE_ENTRY_FILE_NAME);
+    const serveOutput = {
+        clientDirectory: outdir,
+        serverModules: [],
+        externalWorkspaces: new Set(),
+    };
+    yield* writeNodeServeEntry({
+        output: serveOutput,
+        servePath,
+        serveModuleName: NODE_SERVE_ENTRY_FILE_NAME,
+        clientDirExpression: relativeClientDirExpression(servePath, outdir),
+        notFoundHandling,
+        printUrl: isLocal,
+        platform: "node",
+    });
+    if (isLocal) {
+        const runtime = yield* Effect.sync(() => process.execPath);
+        const dev = yield* Command.Dev("Dev", {
+            command: `${runtime} ${servePath}`,
+            cwd: path.dirname(servePath),
+            env: {
+                ...props.env,
+                PORT: "0",
+                HOST: "127.0.0.1",
+                ALCHEMY_BUILD_HASH: build.hash.output,
+            },
+        }).pipe(Namespace.push(id));
+        return { ...empty(), url: Output.map(dev.url, (value) => value) };
+    }
+    const main = servePath;
+    const app = props.app !== undefined
+        ? yield* resolveRef(props.app)
+        : yield* App("App").pipe(Namespace.push(id));
+    const ip = yield* IpAssignment("Shared", { app, type: "shared_v4" }).pipe(Namespace.push(id));
+    // Serve the built tree from the Machine. Fly Tigris `statics` on
+    // `urlPrefix: "/"` do not rewrite HTML routes and hang GET `/`.
+    // Hashed `/assets` still go to Tigris on FrameworkSite.
+    const service = yield* Service(id, {
+        app,
+        deploy: props.deploy,
+        shutdown: props.shutdown,
+        checks: props.checks,
+        services: props.services,
+        main,
+        port: DEFAULT_PORT,
+        // Generated static-file server is a complete bun/node program.
+        isExternal: true,
+        env: props.env,
+        extraFiles: [
+            {
+                // Keep the build dependency so planning cannot hash the previous artifact.
+                source: Output.map(build.outdir, (dir) => path.resolve(initialCwd, dir)),
+                dest: path.basename(outdir),
+            },
+        ],
+    });
+    const certificate = props.domain !== undefined
+        ? yield* Certificate("Certificate", { app, hostname: props.domain, kind: "acme" }).pipe(Namespace.push(id))
+        : undefined;
+    const url = props.domain !== undefined ? `https://${props.domain}` : app.url;
+    return { url, app, service, ip, certificate };
+}).pipe(Effect.orDie);
+//# sourceMappingURL=StaticSite.js.map

package/lib/Website/StaticSite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StaticSite.js","sourceRoot":"","sources":["../../src/Website/StaticSite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAqB,MAAM,eAAe,CAAC;AAC3D,OAAO,EAIL,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,MAAM,UAAU,GAAG,CAAI,GAAW,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAgF1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAU,EAAE,KAAsB,EAAE,EAAE,CAC/D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC;IAClC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,OAAO,KAAK,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAE9B,MAAM,KAAK,GAAG,GAAkB,EAAE,CAAC,CAAC;QAClC,GAAG,EAAE,SAAS;QACd,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,SAAS;QAClB,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,SAAS;KACvB,CAAC,CAAC;IAEH,IAAI,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE;YACpC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO;YAC1B,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI;YAChC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG;SAChC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE;QAC1C,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;QAC5B,GAAG,EAAE,KAAK,CAAC,IAAI;QACf,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QAC1B,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG;KAClC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,gBAAgB,GACpB,QAAQ,CAAC,SAAS,KAAK,SAAS;QAC9B,CAAC,CAAE,UAAoB;QACvB,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,IAAI;YACrB,CAAC,CAAE,KAAe;YAClB,CAAC,CAAE,MAAgB,CAAC;IAE1B,MAAM,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,GACpF,KAAK,CAAC,CAAC,gBAAgB,CAAC;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG;QAClB,eAAe,EAAE,MAAM;QACvB,aAAa,EAAE,EAAE;QACjB,kBAAkB,EAAE,IAAI,GAAG,EAAU;KACtC,CAAC;IACF,KAAK,CAAC,CAAC,mBAAmB,CAAC;QACzB,MAAM,EAAE,WAAW;QACnB,SAAS;QACT,eAAe,EAAE,0BAA0B;QAC3C,mBAAmB,EAAE,2BAA2B,CAAC,SAAS,EAAE,MAAM,CAAC;QACnE,gBAAgB;QAChB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IAEH,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE;YACpC,OAAO,EAAE,GAAG,OAAO,IAAI,SAAS,EAAE;YAClC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAC5B,GAAG,EAAE;gBACH,GAAG,KAAK,CAAC,GAAG;gBACZ,IAAI,EAAE,GAAG;gBACT,IAAI,EAAE,WAAW;gBACjB,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,MAA2B;aAC3D;SACF,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC;IAEvB,MAAM,GAAG,GACP,KAAK,CAAC,GAAG,KAAK,SAAS;QACrB,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC;QAC9B,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9F,iEAAiE;IACjE,gEAAgE;IAChE,wDAAwD;IACxD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE;QACjC,GAAG;QACH,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI;QACJ,IAAI,EAAE,YAAY;QAClB,+DAA+D;QAC/D,UAAU,EAAE,IAAI;QAChB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,UAAU,EAAE;YACV;gBACE,2EAA2E;gBAC3E,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;gBACxE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC;IAEH,MAAM,WAAW,GACf,KAAK,CAAC,MAAM,KAAK,SAAS;QACxB,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CACnF,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CACnB;QACH,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAE7E,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;AAChD,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC"}