import type {
DurableObjectNamespace,
HyperdriveOrigin,
QueueConsumer,
RuntimeWorker,
Workflow,
} from "@alchemy.run/cloudflare-runtime/core";
import type { BundleOutput } from "alchemy/Bundle/Bundle";
import type { FoldkitBuildMetadata } from "../Website/FoldkitBuild.ts";
import type { WorkerAssetsConfig, WorkerSourceDescriptor } from "./Worker.ts";
import type { WorkerBinding } from "./WorkerBinding.ts";
/**
* Default first port of the local dev-server range. Vite and
* cloudflare-runtime advance to the next available port when it is taken,
* unless `strictPort` is set.
*/
export const DEFAULT_DEV_PORT = 1337;
/** Plain-data configuration transferred from the provider to a Vite child. */
export interface ViteChildConfig {
rootDir: string;
publicUrl: string;
accountId: string;
storageDirectory: string;
stack: { name: string; stage: string };
env: Record<string, unknown>;
source?: {
descriptor: WorkerSourceDescriptor;
id: string;
fqn: string;
assets: WorkerAssetsConfig | undefined;
};
worker: {
name: string;
compatibility: { date: string; flags: string[] };
main: string | undefined;
viteEnvironments: { entry?: string; children?: string[] } | undefined;
hasAssets: boolean;
/** The zone outbound `fetch()`es report in `CF-Worker`. */
zone?: string;
bindingDescriptors: WorkerBinding[];
/** Binding name → opt-out of local emulation (`Alchemy.remote()`). */
devRemote: Record<string, boolean>;
/** Simulated Cloudflare Access config (`dev: { access: ... }`). */
devAccess?: { aud?: string; identity?: Record<string, unknown> };
durableObjectNamespaces: (DurableObjectNamespace & {
uniqueKey: string;
})[];
workflows: Workflow[];
hyperdrives: Record<string, Required<HyperdriveOrigin>>;
queueConsumers: QueueConsumer[];
crons: RuntimeWorker["crons"];
/** Tail consumers by script name, resolved through the dev registry. */
tails: RuntimeWorker["tails"];
/** Streaming tail consumers by script name. */
streamingTails: RuntimeWorker["streamingTails"];
/** Cache API opt-out (`dev: { cache: false }`). */
cache: RuntimeWorker["cache"];
/** `request.cf` override (`dev: { cf: {...} }`). */
cf: RuntimeWorker["cf"];
/** workerd process overrides (`dev: { workerd: {...} }`). */
workerd: RuntimeWorker["workerd"];
assets: RuntimeWorker["assets"];
};
}
export const VITE_CHILD_READY_PREFIX = "<ALCHEMY_VITE_ADDRESS>";
export const VITE_CHILD_READY_SUFFIX = "</ALCHEMY_VITE_ADDRESS>";
/**
* Plain-data configuration transferred from the provider to a one-shot
* Vite *build* child (`ViteBuildChildRunner.ts`). Deliberately much
* smaller than {@link ViteChildConfig}: a production build needs no
* workerd runtime, credentials, or binding materialization.
*/
export interface ViteBuildChildConfig {
/** Absolute project root; also the child process's working directory. */
rootDir: string;
/**
* `VITE_`-prefixed env entries — the only ones the build consumes
* (inlined as `import.meta.env.*` defines).
*/
env: Record<string, unknown>;
main: string | undefined;
framework?: "foldkit";
compatibilityDate: string | undefined;
compatibilityFlags: string[] | undefined;
viteEnvironments: { entry?: string; children?: string[] } | undefined;
/** Absolute path the child writes the V8-serialized result to. */
outputPath: string;
}
/** Result the build child writes to `outputPath` (V8-serialized). */
export interface ViteBuildChildResult {
clientDirectory: string | undefined;
foldkit: FoldkitBuildMetadata | undefined;
base: string | undefined;
serverBundle: BundleOutput | undefined;
externalWorkspaces: string[];
}