alchemy 0.12.2 → 0.12.4

package/src/cloudflare/d1-database.ts

@@ -1,12 +1,12 @@
-import type { Context } from "../context";
-import { Resource } from "../resource";
+import type { Context } from "../context.js";
+import { Resource } from "../resource.js";
+import { CloudflareApiError, handleApiError } from "./api-error.js";
 import {
   CloudflareApi,
   createCloudflareApi,
   type CloudflareApiOptions,
-} from "./api";
-import { CloudflareApiError, handleApiError } from "./api-error";
-import { applyMigrations, listMigrationsFiles } from "./d1-migrations";
+} from "./api.js";
+import { applyMigrations, listMigrationsFiles } from "./d1-migrations.js";
 
 /**
  * Properties for creating or updating a D1 Database
@@ -82,40 +82,39 @@ export interface D1DatabaseProps extends CloudflareApiOptions {
 /**
  * Output returned after D1 Database creation/update
  */
-export interface D1Database
-  extends Resource<"cloudflare::D1Database">,
-    D1DatabaseProps {
-  type: "d1";
-  /**
-   * The unique ID of the database (UUID)
-   */
-  id: string;
+export type D1Database = Resource<"cloudflare::D1Database"> &
+  D1DatabaseProps & {
+    type: "d1";
+    /**
+     * The unique ID of the database (UUID)
+     */
+    id: string;
 
-  /**
-   * File size of the database
-   */
-  fileSize: number;
+    /**
+     * File size of the database
+     */
+    fileSize: number;
 
-  /**
-   * Number of tables in the database
-   */
-  numTables: number;
+    /**
+     * Number of tables in the database
+     */
+    numTables: number;
 
-  /**
-   * Version of the database
-   */
-  version: string;
+    /**
+     * Version of the database
+     */
+    version: string;
 
-  /**
-   * Read replication configuration
-   */
-  readReplication?: {
     /**
-     * Read replication mode
+     * Read replication configuration
      */
-    mode: "auto" | "disabled";
+    readReplication?: {
+      /**
+       * Read replication mode
+       */
+      mode: "auto" | "disabled";
+    };
   };
-}
 
 export async function D1Database(
   id: string,
@@ -278,7 +277,7 @@ export const D1DatabaseResource = Resource(
         readReplication: dbData.result.read_replication,
         primaryLocationHint: props.primaryLocationHint,
         accountId: api.accountId,
-        migrationsDir: props.migrationsDir
+        migrationsDir: props.migrationsDir,
       });
     }
   }

package/src/cloudflare/d1-migrations.ts

@@ -1,7 +1,7 @@
-import * as fs from "fs/promises";
+import * as fs from "node:fs/promises";
 import * as path from "node:path";
-import { CloudflareApi } from "./api";
-import { handleApiError } from "./api-error";
+import { handleApiError } from "./api-error.js";
+import { CloudflareApi } from "./api.js";
 
 export interface D1MigrationOptions {
   migrationsFiles: Array<{ id: string; sql: string }>;

package/src/cloudflare/dns-records.ts

@@ -1,16 +1,16 @@
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 import type {
   DnsRecord as BaseDnsRecord,
   DnsRecordType,
   DnsRecordWithMetadata,
-} from "../dns/record";
-import { Resource } from "../resource";
+} from "../dns/record.js";
+import { Resource } from "../resource.js";
 import {
   type CloudflareApi,
   type CloudflareApiOptions,
   createCloudflareApi,
-} from "./api";
-import type { CloudflareResponse } from "./response";
+} from "./api.js";
+import type { CloudflareResponse } from "./response.js";
 
 /**
  * Cloudflare DNS Record response format

package/src/cloudflare/index.ts

@@ -1,25 +1,27 @@
-export * from "./account-api-token";
-export * from "./api";
-export * from "./api-error";
-export * from "./assets";
-export * from "./bindings";
-export * from "./bucket";
-export * from "./custom-domain";
-export * from "./d1-database";
-export * from "./dns-records";
-export * from "./durable-object-namespace";
-export * from "./kv-namespace";
-export * from "./local-dev-cloudflare-shim";
-export * from "./permission-groups";
-export * from "./pipeline";
-export * from "./queue";
-export * from "./r2-rest-state-store";
-export * from "./tanstack-start";
-export * from "./vectorize-index";
-export * from "./vectorize-metadata-index";
-export * from "./vite";
-export * from "./website";
-export * from "./worker";
-export { Workflow } from "./workflow";
-export * from "./wrangler.json";
-export * from "./zone";
+export * from "./account-api-token.js";
+export * from "./api-error.js";
+export * from "./api.js";
+export * from "./assets.js";
+export * from "./bindings.js";
+export * from "./bucket.js";
+export * from "./custom-domain.js";
+export * from "./d1-database.js";
+export * from "./dns-records.js";
+export * from "./durable-object-namespace.js";
+export * from "./kv-namespace.js";
+export * from "./local-dev-cloudflare-shim.js";
+export * from "./nuxt.js";
+export * from "./permission-groups.js";
+export * from "./pipeline.js";
+export * from "./queue.js";
+export * from "./r2-rest-state-store.js";
+export * from "./redwood.js";
+export * from "./tanstack-start.js";
+export * from "./vectorize-index.js";
+export * from "./vectorize-metadata-index.js";
+export * from "./vite.js";
+export * from "./website.js";
+export * from "./worker.js";
+export { Workflow } from "./workflow.js";
+export * from "./wrangler.json.js";
+export * from "./zone.js";

package/src/cloudflare/kv-namespace.ts

@@ -1,12 +1,12 @@
-import type { Context } from "../context";
-import { Resource } from "../resource";
-import { withExponentialBackoff } from "../util/retry";
+import type { Context } from "../context.js";
+import { Resource } from "../resource.js";
+import { withExponentialBackoff } from "../util/retry.js";
+import { handleApiError } from "./api-error.js";
 import {
   CloudflareApi,
   createCloudflareApi,
   type CloudflareApiOptions,
-} from "./api";
-import { handleApiError } from "./api-error";
+} from "./api.js";
 
 /**
  * Properties for creating or updating a KV Namespace

package/src/cloudflare/nuxt.ts

@@ -0,0 +1,66 @@
+import type { Assets } from "./assets.js";
+import type { Bindings } from "./bindings.js";
+import { Website, type WebsiteProps } from "./website.js";
+import type { Worker } from "./worker.js";
+
+/**
+ * Properties for creating a Nuxt resource.
+ * Extends WebsiteProps, allowing customization of the underlying Website.
+ */
+export interface NuxtProps<B extends Bindings> extends WebsiteProps<B> {}
+
+/**
+ * Represents the output of a Nuxt resource deployment.
+ * It resolves to the underlying Cloudflare Worker type, ensuring type safety.
+ * Prevents overriding the internal ASSETS binding.
+ */
+export type Nuxt<B extends Bindings> = B extends { ASSETS: any }
+  ? never
+  : Worker<B & { ASSETS: Assets }>;
+
+/**
+ * Creates and deploys a Nuxt application using the Cloudflare Workers preset.
+ *
+ * This resource simplifies deploying Nuxt applications by providing sensible
+ * defaults for the build command, main entrypoint, and assets directory
+ * based on the `cloudflare-module` preset output.
+ *
+ * It wraps the underlying `Website` resource.
+ *
+ * @param id A unique identifier for the resource.
+ * @param props Configuration options for the Nuxt deployment, overriding defaults.
+ * @returns A promise that resolves to the deployed Cloudflare Worker details.
+ *
+ * @example
+ * // Deploy a basic Nuxt site with default settings
+ * const nuxtSite = await Nuxt("my-nuxt-app");
+ *
+ * @example
+ * // Deploy with custom bindings and build command
+ * const db = await D1Database("my-db");
+ * const nuxtSiteWithDb = await Nuxt("my-nuxt-app-with-db", {
+ *   command: "npm run build:cloudflare", // Specify a custom build command
+ *   bindings: {
+ *     DB: db, // Add custom bindings
+ *   },
+ * });
+ */
+export async function Nuxt<B extends Bindings>(
+  id: string,
+  props?: Partial<NuxtProps<B>>
+): Promise<Nuxt<B>> {
+  // Call the underlying Website resource with Nuxt defaults
+  return Website(id, {
+    ...props,
+    // Default build command, can be overridden by props.command
+    command: props?.command ?? "bun run build",
+    // Default entry point for cloudflare-module preset
+    main: props?.main ?? "./index.ts",
+    // Default static assets directory for cloudflare-module preset
+    assets: props?.assets ?? "./.output/public",
+    // Ensure nodejs_compat flag is included for Nuxt compatibility
+    compatibilityFlags: ["nodejs_compat", ...(props?.compatibilityFlags ?? [])],
+    // Enable wrangler by default, common for Nuxt/Cloudflare deployments
+    wrangler: props?.wrangler ?? true,
+  });
+}

package/src/cloudflare/permission-groups.ts

@@ -1,6 +1,6 @@
-import type { Context } from "../context";
-import { Resource } from "../resource";
-import { createCloudflareApi, type CloudflareApiOptions } from "./api";
+import type { Context } from "../context.js";
+import { Resource } from "../resource.js";
+import { createCloudflareApi, type CloudflareApiOptions } from "./api.js";
 
 /**
  * Cloudflare permission group as returned by the API

package/src/cloudflare/pipeline.ts

@@ -1,12 +1,12 @@
-import type { Context } from "../context";
-import { Resource } from "../resource";
-import type { Secret } from "../secret";
+import type { Context } from "../context.js";
+import { Resource } from "../resource.js";
+import type { Secret } from "../secret.js";
+import { CloudflareApiError, handleApiError } from "./api-error.js";
 import {
   CloudflareApi,
   createCloudflareApi,
   type CloudflareApiOptions,
-} from "./api";
-import { CloudflareApiError, handleApiError } from "./api-error";
+} from "./api.js";
 
 /**
  * Settings for compression of pipeline output

package/src/cloudflare/queue.ts

@@ -1,11 +1,11 @@
-import type { Context } from "../context";
-import { Resource } from "../resource";
+import type { Context } from "../context.js";
+import { Resource } from "../resource.js";
+import { CloudflareApiError, handleApiError } from "./api-error.js";
 import {
   CloudflareApi,
   createCloudflareApi,
   type CloudflareApiOptions,
-} from "./api";
-import { CloudflareApiError, handleApiError } from "./api-error";
+} from "./api.js";
 
 /**
  * Settings for a Cloudflare Queue

package/src/cloudflare/r2-rest-state-store.ts

@@ -1,13 +1,13 @@
-import type { Scope } from "../scope";
-import { deserialize, serialize } from "../serde";
-import type { State, StateStore } from "../state";
-import { withExponentialBackoff } from "../util/retry";
+import type { Scope } from "../scope.js";
+import { deserialize, serialize } from "../serde.js";
+import type { State, StateStore } from "../state.js";
+import { withExponentialBackoff } from "../util/retry.js";
+import { CloudflareApiError, handleApiError } from "./api-error.js";
 import {
   type CloudflareApi,
   type CloudflareApiOptions,
   createCloudflareApi,
-} from "./api";
-import { CloudflareApiError, handleApiError } from "./api-error";
+} from "./api.js";
 
 /**
  * Options for CloudflareR2StateStore

package/src/cloudflare/redwood.ts

@@ -0,0 +1,96 @@
+import path from "node:path";
+import type { Assets } from "./assets.js";
+import type { Bindings } from "./bindings.js";
+import { Website, type WebsiteProps } from "./website.js";
+import type { Worker } from "./worker.js";
+
+export interface RedwoodProps<B extends Bindings> extends WebsiteProps<B> {}
+
+// don't allow the ASSETS to be overridden
+export type Redwood<B extends Bindings> = B extends { ASSETS: any }
+  ? never
+  : Worker<B & { ASSETS: Assets }>;
+
+/**
+ * Deploy a RedwoodJS application to Cloudflare Pages with automatically configured defaults.
+ *
+ * This resource handles the deployment of RedwoodJS applications with optimized settings for
+ * Cloudflare Workers, including proper build commands and compatibility flags.
+ *
+ * @example
+ * // Deploy a basic RedwoodJS application with default settings
+ * const redwoodApp = await Redwood("my-redwood-app");
+ *
+ * @example
+ * // Deploy with a database binding
+ * import { D1Database } from "../cloudflare/d1-database";
+ *
+ * const database = await D1Database("redwood-db");
+ *
+ * const redwoodApp = await Redwood("redwood-with-db", {
+ *   bindings: {
+ *     DB: database
+ *   }
+ * });
+ *
+ * @example
+ * // Deploy with custom build command and environment variables
+ * const redwoodApp = await Redwood("custom-redwood", {
+ *   command: "bun run test && RWSDK_DEPLOY=1 bun run build:production",
+ *   bindings: {
+ *     API_KEY: alchemy.secret("api-key-secret")
+ *   },
+ *   vars: {
+ *     NODE_ENV: "production",
+ *     APP_ENV: "staging"
+ *   }
+ * });
+ *
+ * @example
+ * // Deploy with custom paths and additional compatibility flags
+ * const redwoodApp = await Redwood("redwood-custom-paths", {
+ *   main: "custom/worker.js",
+ *   assets: "custom/static",
+ *   compatibilityFlags: ["nodejs_compat", "fetch_refused_to_set_cookies"]
+ * });
+ *
+ * @example
+ * // Deploy with custom bundle configuration
+ * const redwoodApp = await Redwood("redwood-custom-bundle", {
+ *   bundle: {
+ *     options: {
+ *       external: ["node:events", "node:stream", "node:crypto"],
+ *       format: "esm"
+ *     }
+ *   }
+ * });
+ *
+ * @param id - Unique identifier for the RedwoodJS application
+ * @param props - Configuration properties for the RedwoodJS deployment
+ * @returns A Cloudflare Worker resource representing the deployed RedwoodJS application
+ */
+export async function Redwood<B extends Bindings>(
+  id: string,
+  props?: Partial<RedwoodProps<B>>
+): Promise<Redwood<B>> {
+  return Website(id, {
+    ...props,
+    command: props?.command ?? "bun run clean && RWSDK_DEPLOY=1 bun run build",
+    wrangler: props?.wrangler ?? true,
+    main: props?.main ?? path.join("src", "worker.tsx"),
+    assets: props?.assets ?? path.join("dist", "client"),
+    compatibilityFlags: ["nodejs_compat", ...(props?.compatibilityFlags ?? [])],
+    compatibilityDate: props?.compatibilityDate ?? "2025-04-02",
+    bundle: {
+      ...props?.bundle,
+      options: {
+        ...props?.bundle?.options,
+        external: [
+          "node:events",
+          "node:stream",
+          ...(props?.bundle?.options?.external ?? []),
+        ],
+      },
+    },
+  });
+}

package/src/cloudflare/tanstack-start.ts

@@ -1,7 +1,7 @@
-import type { Assets } from "./assets";
-import type { Bindings } from "./bindings";
-import { Website, type WebsiteProps } from "./website";
-import type { Worker } from "./worker";
+import type { Assets } from "./assets.js";
+import type { Bindings } from "./bindings.js";
+import { Website, type WebsiteProps } from "./website.js";
+import type { Worker } from "./worker.js";
 
 export interface TanStackStartProps<B extends Bindings>
   extends WebsiteProps<B> {}

package/src/cloudflare/vectorize-index.ts

@@ -1,11 +1,11 @@
-import type { Context } from "../context";
-import { Resource } from "../resource";
+import type { Context } from "../context.js";
+import { Resource } from "../resource.js";
+import { CloudflareApiError, handleApiError } from "./api-error.js";
 import {
-  CloudflareApi,
   createCloudflareApi,
+  type CloudflareApi,
   type CloudflareApiOptions,
-} from "./api";
-import { CloudflareApiError, handleApiError } from "./api-error";
+} from "./api.js";
 
 /**
  * Properties for creating or updating a Vectorize Index

package/src/cloudflare/vectorize-metadata-index.ts

@@ -1,12 +1,12 @@
-import type { Context } from "../context";
-import { Resource } from "../resource";
+import type { Context } from "../context.js";
+import { Resource } from "../resource.js";
+import { CloudflareApiError, handleApiError } from "./api-error.js";
 import {
-  CloudflareApi,
   createCloudflareApi,
+  type CloudflareApi,
   type CloudflareApiOptions,
-} from "./api";
-import { CloudflareApiError, handleApiError } from "./api-error";
-import { VectorizeIndex } from "./vectorize-index";
+} from "./api.js";
+import { VectorizeIndex } from "./vectorize-index.js";
 
 /**
  * Properties for creating or deleting a Vectorize Metadata Index

package/src/cloudflare/vite.ts

@@ -1,9 +1,9 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import type { Assets } from "./assets";
-import type { Bindings } from "./bindings";
-import { Website, type WebsiteProps } from "./website";
-import type { Worker } from "./worker";
+import type { Assets } from "./assets.js";
+import type { Bindings } from "./bindings.js";
+import { Website, type WebsiteProps } from "./website.js";
+import type { Worker } from "./worker.js";
 
 export interface ViteProps<B extends Bindings> extends WebsiteProps<B> {}
 

package/src/cloudflare/website.ts

@@ -1,11 +1,11 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { alchemy } from "../alchemy";
-import { Exec } from "../os";
-import { Assets } from "./assets";
-import type { Bindings } from "./bindings";
-import { Worker, type AssetsConfig, type WorkerProps } from "./worker";
-import { WranglerJson } from "./wrangler.json";
+import { alchemy } from "../alchemy.js";
+import { Exec } from "../os/exec.js";
+import { Assets } from "./assets.js";
+import type { Bindings } from "./bindings.js";
+import { Worker, type AssetsConfig, type WorkerProps } from "./worker.js";
+import { WranglerJson } from "./wrangler.json.js";
 
 export interface WebsiteProps<B extends Bindings>
   extends Omit<WorkerProps<B>, "name" | "assets" | "entrypoint"> {

package/src/cloudflare/worker.ts

@@ -1,23 +1,23 @@
 import * as crypto from "node:crypto";
 import * as fs from "node:fs/promises";
-import type { Context } from "../context";
-import { Bundle, type BundleProps } from "../esbuild/bundle";
-import { Resource } from "../resource";
-import { getContentType } from "../util/content-type";
-import { withExponentialBackoff } from "../util/retry";
-import { slugify } from "../util/slugify";
+import type { Context } from "../context.js";
+import { Bundle, type BundleProps } from "../esbuild/bundle.js";
+import { Resource } from "../resource.js";
+import { getContentType } from "../util/content-type.js";
+import { withExponentialBackoff } from "../util/retry.js";
+import { slugify } from "../util/slugify.js";
 import {
   createCloudflareApi,
   type CloudflareApi,
   type CloudflareApiOptions,
-} from "./api";
-import { type Assets } from "./assets";
-import { type Bindings, type WorkerBindingSpec } from "./bindings";
-import type { Bound } from "./bound";
-import { type DurableObjectNamespace } from "./durable-object-namespace";
-import type { WorkerScriptMetadata } from "./worker-metadata";
-import type { SingleStepMigration } from "./worker-migration";
-import { upsertWorkflow, type Workflow } from "./workflow";
+} from "./api.js";
+import { type Assets } from "./assets.js";
+import { type Bindings, type WorkerBindingSpec } from "./bindings.js";
+import type { Bound } from "./bound.js";
+import { type DurableObjectNamespace } from "./durable-object-namespace.js";
+import type { WorkerScriptMetadata } from "./worker-metadata.js";
+import type { SingleStepMigration } from "./worker-migration.js";
+import { upsertWorkflow, type Workflow } from "./workflow.js";
 
 /**
  * Configuration options for static assets
@@ -204,6 +204,16 @@ export interface Worker<B extends Bindings = Bindings>
   Env: {
     [bindingName in keyof B]: Bound<B[bindingName]>;
   };
+
+  /**
+   * The compatibility date for the worker
+   */
+  compatibilityDate: string;
+
+  /**
+   * The compatibility flags for the worker
+   */
+  compatibilityFlags: string[];
 }
 
 /**
@@ -350,11 +360,18 @@ export const Worker = Resource(
       );
     }
 
+    const compatibilityDate = props.compatibilityDate ?? "2024-09-09";
+    const compatibilityFlags = props.compatibilityFlags ?? [];
+
     // Prepare metadata with bindings
     const scriptMetadata = await prepareWorkerMetadata(
       this,
       oldBindings,
-      props,
+      {
+        ...props,
+        compatibilityDate,
+        compatibilityFlags,
+      },
       assetUploadResult
     );
 
@@ -389,6 +406,8 @@ export const Worker = Resource(
       id,
       entrypoint: props.entrypoint,
       name: workerName,
+      compatibilityDate,
+      compatibilityFlags,
       script: scriptContent,
       format: props.format || "esm", // Include format in the output
       bindings: props.bindings ?? ({} as B),
@@ -586,12 +605,15 @@ function createAssetConfig(config?: AssetsConfig): AssetsConfig {
 async function prepareWorkerMetadata<B extends Bindings>(
   ctx: Context<Worker<B>>,
   oldBindings: Bindings | undefined,
-  props: WorkerProps,
+  props: WorkerProps & {
+    compatibilityDate: string;
+    compatibilityFlags: string[];
+  },
   assetUploadResult?: AssetUploadResult
 ): Promise<WorkerMetadata> {
   // Prepare metadata with bindings
   const meta: WorkerMetadata = {
-    compatibility_date: props.compatibilityDate ?? "2024-09-09",
+    compatibility_date: props.compatibilityDate,
     compatibility_flags: props.compatibilityFlags,
     bindings: [],
     observability: {

package/src/cloudflare/workflow.ts

@@ -1,5 +1,5 @@
-import type { CloudflareApi } from "./api";
-import { handleApiError } from "./api-error";
+import { handleApiError } from "./api-error.js";
+import type { CloudflareApi } from "./api.js";
 
 export interface WorkflowProps {
   /**

package/src/cloudflare/wrangler.json.ts

@@ -1,9 +1,9 @@
-import type { Context } from "../context";
-import { StaticJsonFile } from "../fs/static-json-file";
-import { Resource } from "../resource";
-import type { Bindings } from "./bindings";
-import type { DurableObjectNamespace } from "./durable-object-namespace";
-import type { Worker } from "./worker";
+import type { Context } from "../context.js";
+import { StaticJsonFile } from "../fs/static-json-file.js";
+import { Resource } from "../resource.js";
+import type { Bindings } from "./bindings.js";
+import type { DurableObjectNamespace } from "./durable-object-namespace.js";
+import type { Worker } from "./worker.js";
 
 /**
  * Properties for wrangler.json configuration file
@@ -74,7 +74,8 @@ export const WranglerJson = Resource(
       // Use entrypoint as main if it exists
       main: worker.entrypoint,
       // see: https://developers.cloudflare.com/workers/configuration/compatibility-dates/
-      compatibility_date: "2022-04-05",
+      compatibility_date: worker.compatibilityDate,
+      compatibility_flags: props.worker.compatibilityFlags,
     };
 
     // Process bindings if they exist