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

package/lib/Website/FrameworkSite.d.ts

@@ -0,0 +1,212 @@
+import { AlchemyContext } from "alchemy/AlchemyContext";
+import type { MemoOptions } from "alchemy/Command/Memo";
+import * as DNS from "alchemy/DNS/Adapter";
+import * as Output from "alchemy/Output";
+import { staticConfigFromAssets, type WebsiteAssetsProps, type WebsiteNotFoundHandling } from "alchemy/Website/assets";
+import { Server as FrameworkServer, type ServerDevProps } from "alchemy/Website/Server";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Redacted from "effect/Redacted";
+import { App } from "../App.ts";
+import { Certificate } from "../Certificate.ts";
+import { IpAssignment } from "../IpAssignment.ts";
+import type { Providers } from "../Providers.ts";
+import { Service, type ServiceProps } from "../Service.ts";
+/**
+ * A resource-valued prop: the resource itself, or an Effect that produces
+ * it (so `yield* App(...)` and `App(...)` both type-check).
+ */
+export type Ref<T> = T | Effect.Effect<T, never, Providers>;
+export type { ServerDevProps, WebsiteAssetsProps, WebsiteNotFoundHandling };
+export { staticConfigFromAssets };
+/**
+ * Custom hostname of a Fly website: the hostname itself, or
+ * `{ name, dns }` to also publish its DNS records.
+ */
+export type WebsiteDomain = string | {
+    /** Hostname, e.g. `www.example.com`. */
+    name: string;
+    /**
+     * DNS host that publishes the hostname's records (see
+     * [DNS Adapters](/infrastructure-as-code/dns-adapters)), e.g.
+     * `Cloudflare.DNS.Adapter()`: the ACME challenge `CNAME` Fly lists in
+     * the Certificate's `dnsRequirements`, and `A` / `AAAA` records at
+     * the site's addresses. Omitted: publish the records yourself.
+     */
+    dns?: DNS.DnsConfig;
+};
+/** The hostname of a {@link WebsiteDomain}. */
+export declare const websiteDomainName: (domain: WebsiteDomain | undefined) => string | undefined;
+/**
+ * Publish a Fly website's records through `domain.dns`: the Certificate's
+ * ACME challenge `CNAME` (`CertificateValidation`) and `A` / `AAAA`
+ * records at the site's shared IPv4 plus any IPv6 Fly lists for the
+ * hostname (`Domain`). No-op for a plain hostname or an object without
+ * `dns`.
+ */
+export declare const publishWebsiteDomainDns: (args: {
+    readonly domain: WebsiteDomain;
+    readonly certificate: Certificate;
+    readonly ip: IpAssignment;
+}) => Effect.Effect<void, never, never>;
+/**
+ * Props shared by every Fly framework website composite.
+ */
+export interface FrameworkSiteProps {
+    /** Deployment strategy forwarded to the hosted Fly Service. */
+    deploy?: ServiceProps["deploy"];
+    /** Process shutdown policy. The framework server must handle the signal. */
+    shutdown?: ServiceProps["shutdown"];
+    /** Named Machine readiness checks. */
+    checks?: ServiceProps["checks"];
+    /** Override proxy services and their routing health checks. */
+    services?: ServiceProps["services"];
+    /**
+     * Project root directory (the directory containing `package.json`).
+     * @default "."
+     */
+    rootDir?: string;
+    /**
+     * Controls which files are hashed to decide whether the build re-runs.
+     * @default true
+     */
+    memo?: MemoOptions | boolean;
+    /**
+     * Parent Fly App. Accepts a `Fly.App` or an Effect that produces one.
+     * When omitted, a `Fly.App` is created under this site's namespace.
+     */
+    app?: Ref<App>;
+    /**
+     * Process environment for the hosted server. Not Cloudflare Worker
+     * bindings — values become Machine env vars. Accepts `Output`s
+     * (e.g. `VITE_API_URL: api.url`).
+     */
+    env?: Record<string, string | Redacted.Redacted<string> | Output.Output<string | undefined>>;
+    /**
+     * Static-asset routing (`notFoundHandling`, `htmlHandling`). Hashed
+     * client files are uploaded to Tigris regardless of this bag.
+     */
+    assets?: WebsiteAssetsProps;
+    /**
+     * Options for the local dev server that runs this site under
+     * `alchemy dev`.
+     */
+    dev?: ServerDevProps;
+    /**
+     * Optional custom hostname. Requests ACME (`Fly.Certificate`) on the
+     * App and `url` becomes `https://<domain>`.
+     *
+     * A string (or `{ name }`) leaves DNS to you. Set `dns` (e.g.
+     * `{ name: "www.example.com", dns: Cloudflare.DNS.Adapter() }`) to
+     * publish the ACME challenge `CNAME` and the `A` / `AAAA` records
+     * through that DNS host. See
+     * [DNS Adapters](/infrastructure-as-code/dns-adapters).
+     */
+    domain?: WebsiteDomain;
+    /**
+     * User-defined tags. Accepted for API parity; Fly Services do not
+     * surface resource tags.
+     */
+    tags?: Record<string, string>;
+}
+/** Per-framework wiring for {@link makeFrameworkSite}. */
+export interface FrameworkSiteConfig {
+    /** Display name used in error messages (e.g. `"SvelteKit"`). */
+    name: string;
+    /** Framework-integration module specifier. */
+    framework: string;
+    /** Node deploy-target module specifier. */
+    target: string;
+    /**
+     * Framework-specific build options forwarded to the integration (e.g.
+     * `{ kit }`, `{ nuxt }`, `{ astro }`). Must be JSON-serializable.
+     */
+    options?: Record<string, unknown> | undefined;
+    /**
+     * Assets-only routing forwarded to the Node target (Vite SPA fallback).
+     * `spa` also publishes client files to Tigris at `/`.
+     */
+    static?: {
+        spa?: boolean;
+        errorPage?: string;
+    } | undefined;
+    /**
+     * Vocs/Waku: serve `about/index.html` at `/about`.
+     * @default "none"
+     */
+    htmlHandling?: "none" | "drop-trailing-slash";
+    /**
+     * Packages installed into the Machine image with `npm install` instead
+     * of bundling (Next.js needs `next`).
+     */
+    install?: string[] | undefined;
+    /**
+     * Skip baking `clientDirectory` at `/app/dist`. Next.js serves `.next`
+     * from the image root instead.
+     */
+    skipClientAssets?: boolean | undefined;
+}
+export interface FrameworkSite {
+    /**
+     * Public site URL. Local framework URL under `alchemy dev`;
+     * `https://{app}.fly.dev` (or `https://{domain}`) on deploy.
+     */
+    url: string | Output.Output<string | undefined> | undefined;
+    /** Parent Fly App. `undefined` during `alchemy dev`. */
+    app: App | undefined;
+    /** Hosted Fly Service. `undefined` during `alchemy dev`. */
+    service: Service | undefined;
+    /** Shared Anycast IPv4 so `{app}.fly.dev` answers. */
+    ip: IpAssignment | undefined;
+    /** ACME certificate when {@link FrameworkSiteProps.domain} is set. */
+    certificate: Certificate | undefined;
+}
+declare const FrameworkSiteError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FrameworkSiteError";
+} & Readonly<A>;
+export declare class FrameworkSiteError extends FrameworkSiteError_base<{
+    readonly framework: string;
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
+/**
+ * Shared implementation behind the Fly framework website composites:
+ * `Website.Server` runs the framework toolchain (dev sidecar / production
+ * build), then a live deploy hosts `serve-node.mjs` on a Fly.Service.
+ *
+ * Callers pipe `Namespace.push(id)` themselves (the composites do).
+ *
+ * Composite-level tagged errors (`FrameworkSiteError`, filesystem) are
+ * defects — `Alchemy.Stack` only admits `ConfigError` on the user
+ * effect, same as Cloudflare/AWS Website composites.
+ */
+export declare const makeFrameworkSite: (id: string, props: FrameworkSiteProps, config: FrameworkSiteConfig) => Effect.Effect<{
+    url: Output.Output<string | undefined, never>;
+    app: undefined;
+    service: undefined;
+    ip: undefined;
+    certificate: undefined;
+} | {
+    url: string | Output.Output<string, never>;
+    app: App;
+    service: Service;
+    ip: IpAssignment;
+    certificate: Certificate | undefined;
+}, never, AlchemyContext | FileSystem.FileSystem | Path.Path | import("alchemy/Provider").Provider<FrameworkServer> | Providers>;
+/** Push {@link id} then run {@link makeFrameworkSite}. */
+export declare const frameworkSite: (id: string, props: FrameworkSiteProps, config: FrameworkSiteConfig) => Effect.Effect<{
+    url: Output.Output<string | undefined, never>;
+    app: undefined;
+    service: undefined;
+    ip: undefined;
+    certificate: undefined;
+} | {
+    url: string | Output.Output<string, never>;
+    app: App;
+    service: Service;
+    ip: IpAssignment;
+    certificate: Certificate | undefined;
+}, never, AlchemyContext | FileSystem.FileSystem | Path.Path | import("alchemy/Provider").Provider<FrameworkServer> | Providers>;
+//# sourceMappingURL=FrameworkSite.d.ts.map

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

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

package/lib/Website/FrameworkSite.js

@@ -0,0 +1,205 @@
+import { AlchemyContext } from "alchemy/AlchemyContext";
+import * as DNS from "alchemy/DNS/Adapter";
+import * as Namespace from "alchemy/Namespace";
+import * as Output from "alchemy/Output";
+import { ProviderModePolicy } from "alchemy/ProviderMode";
+import { initialCwd } from "alchemy/Util/Node";
+import { staticConfigFromAssets, } from "alchemy/Website/assets";
+import { packSiteExtraFiles } from "alchemy/Website/packExtraFiles";
+import { Server as FrameworkServer } from "alchemy/Website/Server";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Redacted from "effect/Redacted";
+import { App } from "../App.js";
+import { Bucket } from "../Bucket.js";
+import { Certificate } from "../Certificate.js";
+import { IpAssignment } from "../IpAssignment.js";
+import { Service } from "../Service.js";
+import { AssetDeployment } from "./AssetDeployment.js";
+export { staticConfigFromAssets };
+/** The hostname of a {@link WebsiteDomain}. */
+export const websiteDomainName = (domain) => domain === undefined || typeof domain === "string" ? domain : domain.name;
+const acmeChallengeRecords = (hostname, requirements) => {
+    const challenge = requirements?.acmeChallenge;
+    if (challenge?.target === undefined || challenge.target.length === 0) {
+        return [];
+    }
+    const expected = `_acme-challenge.${hostname}`;
+    const name = challenge.name !== undefined &&
+        DNS.normalizeDnsName(challenge.name).endsWith(DNS.normalizeDnsName(hostname))
+        ? challenge.name
+        : expected;
+    return [{ name, type: "CNAME", value: challenge.target }];
+};
+/**
+ * Publish a Fly website's records through `domain.dns`: the Certificate's
+ * ACME challenge `CNAME` (`CertificateValidation`) and `A` / `AAAA`
+ * records at the site's shared IPv4 plus any IPv6 Fly lists for the
+ * hostname (`Domain`). No-op for a plain hostname or an object without
+ * `dns`.
+ */
+export const publishWebsiteDomainDns = Effect.fn("Fly.Website.publishDomainDns")(function* (args) {
+    if (typeof args.domain === "string" || args.domain.dns === undefined) {
+        return;
+    }
+    const dns = yield* DNS.resolve(args.domain.dns);
+    const name = args.domain.name;
+    yield* dns.records("CertificateValidation", {
+        records: Output.map(args.certificate.dnsRequirements, (requirements) => acmeChallengeRecords(name, requirements)),
+    });
+    yield* dns.alias("Domain", {
+        name,
+        target: {
+            ipv4: Output.map(args.ip.ip, (ip) => [ip]),
+            ipv6: Output.map(args.certificate.dnsRequirements, (requirements) => requirements?.aaaa ?? []),
+        },
+    });
+});
+export class FrameworkSiteError extends Data.TaggedError("FrameworkSiteError") {
+}
+const DEFAULT_PORT = 3000;
+const resolveRef = (ref) => Effect.isEffect(ref) ? ref : Effect.succeed(ref);
+const envRecord = (env) => {
+    if (env === undefined)
+        return undefined;
+    return Object.fromEntries(Object.entries(env).map(([key, value]) => [
+        key,
+        Redacted.isRedacted(value) ? Redacted.value(value) : value,
+    ]));
+};
+const runFrameworkSite = Effect.fn("Fly.Website.FrameworkSite")(function* (_id, props, config) {
+    const ctx = yield* AlchemyContext;
+    const remoted = yield* ProviderModePolicy;
+    const isLocal = ctx.dev && remoted !== true;
+    const path = yield* Path.Path;
+    const fs = yield* FileSystem.FileSystem;
+    const build = yield* FrameworkServer("Build", {
+        framework: config.framework,
+        target: config.target,
+        root: props.rootDir,
+        env: envRecord(props.env),
+        options: config.options,
+        memo: props.memo,
+        dev: props.dev,
+    });
+    if (isLocal) {
+        return {
+            url: build.url,
+            app: undefined,
+            service: undefined,
+            ip: undefined,
+            certificate: undefined,
+        };
+    }
+    // The build runs at APPLY time (`Website.Server` is a resource), so its
+    // attributes are Outputs here — derive every deploy input lazily and let
+    // the engine resolve them once the build has produced real paths. Reading
+    // `build.distDir` eagerly in the composite body would observe an Output
+    // proxy, not a string.
+    const buildOut = Output.mapEffect(([serverEntry, distDir]) => Effect.gen(function* () {
+        if (serverEntry === undefined || distDir === undefined) {
+            return yield* Effect.die(new FrameworkSiteError({
+                framework: config.framework,
+                message: `The ${config.name} build produced no Node serve entry (serverModules[0]). The Node deploy target should write serve-node.mjs.`,
+            }));
+        }
+        const main = path.resolve(initialCwd, serverEntry);
+        if (!(yield* fs.exists(main).pipe(Effect.orElseSucceed(() => false)))) {
+            return yield* Effect.die(new FrameworkSiteError({
+                framework: config.framework,
+                message: `The ${config.name} build produced no server entry at ${main}`,
+            }));
+        }
+        return { distDir: path.resolve(initialCwd, distDir), main };
+    }))(Output.all(build.serverEntry, build.distDir));
+    const main = Output.map(buildOut, (out) => out.main);
+    const extraFiles = Output.mapEffect((out) => packSiteExtraFiles(out.distDir, config.skipClientAssets === true ? "next" : "client"))(buildOut);
+    const app = props.app !== undefined ? yield* resolveRef(props.app) : yield* App("App");
+    const ip = yield* IpAssignment("Shared", {
+        app,
+        type: "shared_v4",
+    });
+    // SPA: hashed `/assets` at Tigris. HTML and unknown paths stay on
+    // origin (NodeServe `notFoundHandling: "spa"`). Intercepting `/` with
+    // Tigris hangs SPA fallbacks — Fly does not rewrite `/counter/42` to
+    // `index.html`.
+    let statics;
+    if (config.static?.spa === true) {
+        const clientDir = Output.map(build.clientDir, (dir) => {
+            if (dir === undefined) {
+                throw new FrameworkSiteError({
+                    framework: config.framework,
+                    message: `The ${config.name} build produced no client assets directory`,
+                });
+            }
+            return path.resolve(initialCwd, dir);
+        });
+        const bucket = yield* Bucket("Assets", { public: true });
+        yield* AssetDeployment("Files", {
+            bucket,
+            sourcePath: clientDir,
+            purge: true,
+        });
+        statics = Output.mapEffect(([clientDir, bucketName]) => Effect.gen(function* () {
+            const assetsDir = path.join(clientDir, "assets");
+            const exists = yield* fs.exists(assetsDir).pipe(Effect.orElseSucceed(() => false));
+            return exists
+                ? [
+                    {
+                        guestPath: "/assets",
+                        urlPrefix: "/assets",
+                        tigrisBucket: bucketName,
+                    },
+                ]
+                : undefined;
+        }))(Output.all(clientDir, bucket.name));
+    }
+    const service = yield* Service("Service", {
+        app,
+        deploy: props.deploy,
+        shutdown: props.shutdown,
+        checks: props.checks,
+        services: props.services,
+        main: main,
+        port: DEFAULT_PORT,
+        // Node + nitro SSR needs more than the Machine default 256MB.
+        guest: { memoryMb: 512 },
+        isExternal: true,
+        env: props.env,
+        extraFiles: extraFiles,
+        statics: statics,
+        build: config.install !== undefined && config.install.length > 0
+            ? { install: config.install }
+            : undefined,
+    });
+    const domainName = websiteDomainName(props.domain);
+    const certificate = domainName !== undefined
+        ? yield* Certificate("Certificate", {
+            app,
+            hostname: domainName,
+            kind: "acme",
+        })
+        : undefined;
+    if (props.domain !== undefined && certificate !== undefined) {
+        yield* publishWebsiteDomainDns({ domain: props.domain, certificate, ip });
+    }
+    const url = domainName !== undefined ? `https://${domainName}` : app.url;
+    return { url, app, service, ip, certificate };
+});
+/**
+ * Shared implementation behind the Fly framework website composites:
+ * `Website.Server` runs the framework toolchain (dev sidecar / production
+ * build), then a live deploy hosts `serve-node.mjs` on a Fly.Service.
+ *
+ * Callers pipe `Namespace.push(id)` themselves (the composites do).
+ *
+ * Composite-level tagged errors (`FrameworkSiteError`, filesystem) are
+ * defects — `Alchemy.Stack` only admits `ConfigError` on the user
+ * effect, same as Cloudflare/AWS Website composites.
+ */
+export const makeFrameworkSite = (id, props, config) => runFrameworkSite(id, props, config).pipe(Effect.orDie);
+/** Push {@link id} then run {@link makeFrameworkSite}. */
+export const frameworkSite = (id, props, config) => makeFrameworkSite(id, props, config).pipe(Namespace.push(id));
+//# sourceMappingURL=FrameworkSite.js.map

package/lib/Website/FrameworkSite.js.map

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

package/lib/Website/Nextjs.d.ts

@@ -0,0 +1,54 @@
+import { type FrameworkSiteProps } from "./FrameworkSite.ts";
+/**
+ * The Next.js-on-Node framework module (`next build` + a custom
+ * `next({ dev: false })` server). Not OpenNext.
+ */
+export declare const NEXTJS_NODE_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/nextjs/node";
+export interface NextjsProps extends FrameworkSiteProps {
+}
+/**
+ * Deploy a Next.js application to Fly as a long-running Node process:
+ * `next build`, then a serve entry that `import("next")` +
+ * `next({ dev: false }).prepare()` + `getRequestHandler()`. The `.next`
+ * output (and `public/` when present) is baked into the image; `next` is
+ * installed unbundled.
+ *
+ * Do not use OpenNext AWS/CF wrappers — those are Lambda/workerd.
+ *
+ * During `alchemy dev` the site is `next dev` and no cloud resources are
+ * declared; `Alchemy.remote()` opts back into the live Service path.
+ *
+ *
+ * ### Creating Next.js Sites
+ * **Example:** Basic Next.js App
+ * ```typescript
+ * const site = yield* Fly.Website.Nextjs("Web", {
+ *   rootDir: "./app",
+ * });
+ * ```
+ *
+ * **Example:** Custom Domain
+ * ```typescript
+ * const site = yield* Fly.Website.Nextjs("Web", {
+ *   rootDir: "./app",
+ *   domain: "app.example.com",
+ * });
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export declare const Nextjs: (id: string, props?: NextjsProps) => 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=Nextjs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Nextjs.d.ts","sourceRoot":"","sources":["../../src/Website/Nextjs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,+BAA+B,iDAAiD,CAAC;AAE9F,MAAM,WAAW,WAAY,SAAQ,kBAAkB;CAAG;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,MAAM,OAAQ,MAAM,UAAS,WAAW;;;;;;;;;;;;qPAOjD,CAAC"}

package/lib/Website/Nextjs.js

@@ -0,0 +1,46 @@
+import { frameworkSite } from "./FrameworkSite.js";
+/**
+ * The Next.js-on-Node framework module (`next build` + a custom
+ * `next({ dev: false })` server). Not OpenNext.
+ */
+export const NEXTJS_NODE_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/nextjs/node";
+/**
+ * Deploy a Next.js application to Fly as a long-running Node process:
+ * `next build`, then a serve entry that `import("next")` +
+ * `next({ dev: false }).prepare()` + `getRequestHandler()`. The `.next`
+ * output (and `public/` when present) is baked into the image; `next` is
+ * installed unbundled.
+ *
+ * Do not use OpenNext AWS/CF wrappers — those are Lambda/workerd.
+ *
+ * During `alchemy dev` the site is `next dev` and no cloud resources are
+ * declared; `Alchemy.remote()` opts back into the live Service path.
+ *
+ *
+ * ### Creating Next.js Sites
+ * **Example:** Basic Next.js App
+ * ```typescript
+ * const site = yield* Fly.Website.Nextjs("Web", {
+ *   rootDir: "./app",
+ * });
+ * ```
+ *
+ * **Example:** Custom Domain
+ * ```typescript
+ * const site = yield* Fly.Website.Nextjs("Web", {
+ *   rootDir: "./app",
+ *   domain: "app.example.com",
+ * });
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export const Nextjs = (id, props = {}) => frameworkSite(id, props, {
+    name: "Next.js",
+    framework: NEXTJS_NODE_FRAMEWORK_SPECIFIER,
+    target: NEXTJS_NODE_FRAMEWORK_SPECIFIER,
+    install: ["next", "react", "react-dom"],
+    skipClientAssets: true,
+});
+//# sourceMappingURL=Nextjs.js.map

package/lib/Website/Nextjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nextjs.js","sourceRoot":"","sources":["../../src/Website/Nextjs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAE5E;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,8CAA8C,CAAC;AAI9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,KAAK,GAAgB,EAAE,EAAE,EAAE,CAC5D,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE;IACvB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,+BAA+B;IAC1C,MAAM,EAAE,+BAA+B;IACvC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;IACvC,gBAAgB,EAAE,IAAI;CACvB,CAAC,CAAC"}

package/lib/Website/Nuxt.d.ts

@@ -0,0 +1,51 @@
+import { type FrameworkSiteProps } from "./FrameworkSite.ts";
+/** The framework-integration package that drives the Nuxt build. */
+export declare const NUXT_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/nuxt";
+/** The Node container deploy target for the Nuxt build. */
+export declare const NUXT_NODE_TARGET_SPECIFIER = "@alchemy.run/frontend-frameworks/nuxt/node";
+export interface NuxtProps extends FrameworkSiteProps {
+    /**
+     * Nuxt config overrides merged over the project's own `nuxt.config.ts`
+     * (highest-priority layer). `nitro.preset` is owned by the Node deploy
+     * target and may not be set here.
+     */
+    nuxt?: Record<string, unknown>;
+}
+/**
+ * Deploy a Nuxt application to Fly: the nitro Node server on a Machine,
+ * static assets (prerendered pages included) baked into the image.
+ *
+ *
+ * ### Creating Nuxt Sites
+ * **Example:** Basic Nuxt App
+ * ```typescript
+ * const site = yield* Fly.Website.Nuxt("Web", {
+ *   rootDir: "./app",
+ * });
+ * ```
+ *
+ * **Example:** Custom Domain
+ * ```typescript
+ * const site = yield* Fly.Website.Nuxt("Web", {
+ *   rootDir: "./app",
+ *   domain: "app.example.com",
+ * });
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export declare const Nuxt: (id: string, props?: NuxtProps) => 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=Nuxt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Nuxt.d.ts","sourceRoot":"","sources":["../../src/Website/Nuxt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,0CAA0C,CAAC;AAEhF,2DAA2D;AAC3D,eAAO,MAAM,0BAA0B,+CAA+C,CAAC;AAEvF,MAAM,WAAW,SAAU,SAAQ,kBAAkB;IACnD;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,IAAI,OAAQ,MAAM,UAAS,SAAS;;;;;;;;;;;;qPAM7C,CAAC"}

package/lib/Website/Nuxt.js

@@ -0,0 +1,36 @@
+import { frameworkSite } from "./FrameworkSite.js";
+/** The framework-integration package that drives the Nuxt build. */
+export const NUXT_FRAMEWORK_SPECIFIER = "@alchemy.run/frontend-frameworks/nuxt";
+/** The Node container deploy target for the Nuxt build. */
+export const NUXT_NODE_TARGET_SPECIFIER = "@alchemy.run/frontend-frameworks/nuxt/node";
+/**
+ * Deploy a Nuxt application to Fly: the nitro Node server on a Machine,
+ * static assets (prerendered pages included) baked into the image.
+ *
+ *
+ * ### Creating Nuxt Sites
+ * **Example:** Basic Nuxt App
+ * ```typescript
+ * const site = yield* Fly.Website.Nuxt("Web", {
+ *   rootDir: "./app",
+ * });
+ * ```
+ *
+ * **Example:** Custom Domain
+ * ```typescript
+ * const site = yield* Fly.Website.Nuxt("Web", {
+ *   rootDir: "./app",
+ *   domain: "app.example.com",
+ * });
+ * ```
+ *
+ * @resource
+ * @product Website
+ */
+export const Nuxt = (id, props = {}) => frameworkSite(id, props, {
+    name: "Nuxt",
+    framework: NUXT_FRAMEWORK_SPECIFIER,
+    target: NUXT_NODE_TARGET_SPECIFIER,
+    options: props.nuxt ? { nuxt: props.nuxt } : undefined,
+});
+//# sourceMappingURL=Nuxt.js.map

package/lib/Website/Nuxt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nuxt.js","sourceRoot":"","sources":["../../src/Website/Nuxt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAE5E,oEAAoE;AACpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,uCAAuC,CAAC;AAEhF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,4CAA4C,CAAC;AAWvF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,KAAK,GAAc,EAAE,EAAE,EAAE,CACxD,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE;IACvB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,wBAAwB;IACnC,MAAM,EAAE,0BAA0B;IAClC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;CACvD,CAAC,CAAC"}