alchemy 0.63.1 → 0.65.0

package/src/util/dedent.ts

@@ -1,71 +1,55 @@
 /**
- * Removes common indentation from template literals to make them more readable in code.
- * This allows writing multi-line strings with proper indentation in the source code
- * while removing that indentation in the output string.
+ * Tagged template literal for removing indentation from a block of text.
  *
- * @example
- * const message = dedent`
- *   This is a multi-line string
- *   that will have its indentation removed.
- *     This line has extra indentation that will be preserved.
- * `;
- * // Result:
- * // "This is a multi-line string
- * // that will have its indentation removed.
- * //   This line has extra indentation that will be preserved."
+ * If the first line is empty, it will be ignored.
  */
-export function dedent(
-  strings: TemplateStringsArray,
-  ...values: any[]
-): string {
-  // Combine the template strings and values
-  const result = strings.reduce((acc, str, i) => {
-    return acc + str + (values[i] !== undefined ? values[i] : "");
-  }, "");
+export function dedent(strings: TemplateStringsArray, ...values: unknown[]) {
+  // Convert template literal arguments back to a regular string
+  const raw = String.raw({ raw: strings }, ...values);
+  // Split the string by lines
+  let lines = raw.split("\n");
 
-  // Split into lines
-  const lines = result.split("\n");
-
-  // Remove ALL leading blank/whitespace-only lines
+  // Remove leading blank lines
   while (lines.length > 0 && lines[0].trim() === "") {
-    lines.shift();
+    lines = lines.slice(1);
   }
 
-  // Remove ALL trailing blank/whitespace-only lines
+  // Remove trailing blank lines
   while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
-    lines.pop();
+    lines = lines.slice(0, lines.length - 1);
   }
 
-  // If there are no lines left after trimming, return an empty string
+  // If no content lines remain, return empty string
   if (lines.length === 0) {
     return "";
   }
 
-  // Find the minimum indentation level (excluding empty/whitespace lines)
-  const minIndent = lines
-    .filter((line) => line.trim().length > 0) // Only consider non-blank lines for indent calculation
-    .reduce((min, line) => {
-      const indent = line.match(/^[ \t]*/)?.[0].length || 0;
-      // Handle potentially infinite min if all lines are blank (though handled by early return)
-      return indent < min ? indent : min;
-    }, Number.POSITIVE_INFINITY);
+  // Find the minimum-length indent from content lines (non-blank lines)
+  let minIndentLength = Number.POSITIVE_INFINITY;
+  for (const line of lines) {
+    if (line.trim() !== "") {
+      const indent = line.match(/^[ \t]*/)?.[0];
+      if (indent != null && indent.length < minIndentLength) {
+        minIndentLength = indent.length;
+      }
+    }
+  }
 
-  // If minIndent remains Infinity (only blank lines existed), return empty string.
-  // This case should be caught by the lines.length check above, but belt-and-suspenders.
-  if (minIndent === Number.POSITIVE_INFINITY) {
-    return "";
+  // If no indentation found, return lines as-is
+  if (minIndentLength === Number.POSITIVE_INFINITY) {
+    return lines.join("\n");
   }
 
-  // Remove the common indentation from each line
-  const dedented = lines.map((line) => {
-    // Preserve internal blank lines as empty strings, don't try to substring them
-    if (line.trim().length === 0) {
-      return "";
+  // Remove indent from all lines, preserving blank lines
+  lines = lines.map((line) => {
+    if (line.trim() === "") {
+      return line; // Preserve blank lines
     }
-    // Apply dedent only to lines with content
-    return line.substring(minIndent);
+    return line.startsWith(" ".repeat(minIndentLength)) ||
+      line.startsWith("\t".repeat(minIndentLength))
+      ? line.substring(minIndentLength)
+      : line;
   });
 
-  // Join the lines back together
-  return dedented.join("\n");
+  return lines.join("\n");
 }

package/src/util/memoize.ts

@@ -1,4 +1,5 @@
 import { createHash } from "node:crypto";
+import { isSecret } from "../secret.ts";
 
 type AsyncReturnType<T> = T extends (...args: any[]) => Promise<infer R>
   ? R
@@ -25,5 +26,16 @@ export function memoize<F extends (...args: any[]) => Promise<any>>(
 }
 
 export const defaultKeyFn = (...args: any[]) => {
-  return createHash("sha256").update(JSON.stringify(args)).digest("hex");
+  return createHash("sha256")
+    .update(
+      JSON.stringify(args, (_, value) => {
+        // Secret names may differ between instantiations,
+        // so we unwrap it to make the key deterministic.
+        if (isSecret(value)) {
+          return value.unencrypted;
+        }
+        return value;
+      }),
+    )
+    .digest("hex");
 };

package/templates/astro/alchemy.run.ts

@@ -5,9 +5,7 @@ import { Astro } from "alchemy/cloudflare";
 
 const app = await alchemy("{projectName}");
 
-export const worker = await Astro("website", {
-  name: `${app.name}-${app.stage}-website`,
-});
+export const worker = await Astro("website");
 
 console.log({
   url: worker.url,

package/templates/hono/alchemy.run.ts

@@ -10,7 +10,6 @@ const kv = await KVNamespace("kv", {
 });
 
 export const worker = await Worker("worker", {
-  name: `${app.name}-${app.stage}`,
   entrypoint: "src/index.ts",
   bindings: {
     KV: kv,

package/templates/nextjs/README.md

@@ -0,0 +1,85 @@
+# Welcome to Next.js on Cloudflare!
+
+[![Deployed with Alchemy](https://alchemy.run/alchemy-badge.svg)](https://alchemy.run)
+
+A modern, production-ready template for building full-stack React applications using Next.js on Cloudflare Workers.
+
+## Features
+
+- 🚀 Server-side rendering with React Server Components
+- ⚡️ Hot Module Replacement (HMR)
+- 📦 Asset bundling and optimization via OpenNext
+- 🔄 Server Actions and API routes
+- 🔒 TypeScript by default
+- 🌐 Cloudflare Workers runtime
+- 📖 [Next.js docs](https://nextjs.org/docs)
+
+## Getting Started
+
+### Installation
+
+Install the dependencies:
+
+```bash
+npm install
+```
+
+### Development
+
+Start the development server with HMR:
+
+```bash
+npm run dev
+```
+
+Your application will be available at `http://localhost:3000`.
+
+## Building for Production
+
+Create a production build:
+
+```bash
+npm run build
+```
+
+## Deployment
+
+Deploy to Cloudflare Workers:
+
+```bash
+npm run deploy
+```
+
+## Preview
+
+Preview the production build locally:
+
+```bash
+npm run preview
+```
+
+## Destroy
+
+Clean up all Cloudflare resources:
+
+```bash
+npm run destroy
+```
+
+## Project Structure
+
+- `src/app/` - Next.js App Router pages and components
+- `public/` - Static assets
+- `alchemy.run.ts` - Infrastructure configuration
+- `next.config.ts` - Next.js configuration
+- `open-next.config.ts` - OpenNext configuration for Cloudflare
+
+## Learn More
+
+- [Next.js Documentation](https://nextjs.org/docs)
+- [Alchemy Documentation](https://alchemy.run)
+- [OpenNext for Cloudflare](https://opennext.js.org/cloudflare)
+
+---
+
+Built with ❤️ using Next.js and Alchemy.

package/templates/nextjs/_env

@@ -0,0 +1 @@
+ALCHEMY_PASSWORD=change-me

package/templates/nextjs/_env.example

@@ -0,0 +1 @@
+ALCHEMY_PASSWORD=change-me

package/templates/nextjs/_gitignore

@@ -0,0 +1,46 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env
+.env.*
+!.env.example
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+# alchemy
+.alchemy/
+.wrangler/
+wrangler.jsonc
+
+# opennext
+.open-next/

package/templates/nextjs/alchemy.run.ts

@@ -0,0 +1,16 @@
+/// <reference types="@types/node" />
+
+import alchemy from "alchemy";
+import { Nextjs } from "alchemy/cloudflare";
+
+const app = await alchemy("{projectName}");
+
+export const website = await Nextjs("website", {
+  name: `${app.name}-${app.stage}-website`,
+});
+
+console.log({
+  url: website.url,
+});
+
+await app.finalize();

package/templates/nextjs/eslint.config.mjs

@@ -0,0 +1,16 @@
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { FlatCompat } from "@eslint/eslintrc";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+});
+
+const eslintConfig = [
+  ...compat.extends("next/core-web-vitals", "next/typescript"),
+];
+
+export default eslintConfig;

package/templates/nextjs/next-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/basic-features/typescript for more information.

package/templates/nextjs/next.config.ts

@@ -0,0 +1,10 @@
+import { initOpenNextCloudflareForDev } from "@opennextjs/cloudflare";
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;
+
+initOpenNextCloudflareForDev();

package/templates/nextjs/open-next.config.ts

@@ -0,0 +1,5 @@
+import { defineCloudflareConfig } from "@opennextjs/cloudflare";
+
+export default defineCloudflareConfig({
+  // Configure OpenNext for Cloudflare Workers
+});

package/templates/nextjs/package.json

@@ -0,0 +1,31 @@
+{
+  "type": "module",
+  "name": "@alchemy.run/nextjs-template",
+  "private": true,
+  "scripts": {
+    "build": "next build",
+    "deploy": "alchemy deploy",
+    "destroy": "alchemy destroy",
+    "dev": "alchemy dev",
+    "lint": "next lint",
+    "start": "next start"
+  },
+  "dependencies": {
+    "@opennextjs/cloudflare": "^1.6.5",
+    "next": "15.4.6",
+    "react": "19.1.0",
+    "react-dom": "19.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "alchemy": "workspace:*",
+    "@cloudflare/workers-types": "^4.20250805.0",
+    "eslint": "^9",
+    "eslint-config-next": "15.4.6",
+    "sharp": "^0.34.3",
+    "typescript": "^5.8.3",
+    "wrangler": "^4.30.0"
+  }
+}

package/templates/nextjs/src/app/api/hello/route.ts

@@ -0,0 +1,19 @@
+import { NextRequest } from "next/server";
+
+export async function GET(request: NextRequest) {
+  return Response.json({
+    message: "Hello from Next.js on Cloudflare Workers!",
+    timestamp: new Date().toISOString(),
+    url: request.url,
+  });
+}
+
+export async function POST(request: NextRequest) {
+  const body = await request.json();
+  
+  return Response.json({
+    message: "POST received",
+    data: body,
+    timestamp: new Date().toISOString(),
+  });
+}

package/templates/nextjs/src/app/globals.css

@@ -0,0 +1,72 @@
+* {
+  box-sizing: border-box;
+  padding: 0;
+  margin: 0;
+}
+
+html,
+body {
+  max-width: 100vw;
+  overflow-x: hidden;
+  font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  line-height: 1.6;
+  color: #333;
+}
+
+.container {
+  max-width: 800px;
+  margin: 0 auto;
+  padding: 2rem;
+}
+
+h1 {
+  font-size: 2.5rem;
+  margin-bottom: 1rem;
+  color: #2563eb;
+}
+
+h2 {
+  font-size: 1.5rem;
+  margin: 2rem 0 1rem 0;
+  color: #1f2937;
+}
+
+p {
+  margin-bottom: 1rem;
+}
+
+a {
+  color: #2563eb;
+  text-decoration: underline;
+}
+
+a:hover {
+  text-decoration: none;
+}
+
+code {
+  background: #f3f4f6;
+  padding: 0.2rem 0.4rem;
+  border-radius: 0.25rem;
+  font-family: 'SF Mono', Consolas, monospace;
+  font-size: 0.875rem;
+}
+
+section {
+  margin: 2rem 0;
+}
+
+ul {
+  padding-left: 2rem;
+}
+
+li {
+  margin: 0.5rem 0;
+}
+
+footer {
+  margin-top: 3rem;
+  padding-top: 2rem;
+  border-top: 1px solid #e5e7eb;
+  color: #6b7280;
+}

package/templates/nextjs/src/app/layout.tsx

@@ -0,0 +1,19 @@
+import type { Metadata } from "next";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "Next.js on Cloudflare Workers",
+  description: "Built with Alchemy",
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/nextjs/src/app/page.tsx

@@ -0,0 +1,55 @@
+export default function Home() {
+  return (
+    <main className="container">
+      <h1>Welcome to Next.js on Cloudflare Workers!</h1>
+      <p>
+        This is a Next.js application deployed to Cloudflare Workers using{" "}
+        <a 
+          href="https://alchemy.run" 
+          target="_blank" 
+          rel="noopener noreferrer"
+        >
+          Alchemy
+        </a>.
+      </p>
+      
+      <section>
+        <h2>Features</h2>
+        <ul>
+          <li>🚀 Server-side rendering</li>
+          <li>⚡️ Hot Module Replacement</li>
+          <li>📦 Asset optimization</li>
+          <li>🔄 Server Actions</li>
+          <li>🔒 TypeScript</li>
+          <li>🌐 Edge runtime</li>
+        </ul>
+      </section>
+
+      <section>
+        <h2>Get Started</h2>
+        <p>Edit <code>src/app/page.tsx</code> and save to see your changes.</p>
+      </section>
+
+      <footer>
+        <p>
+          Learn more:{" "}
+          <a 
+            href="https://nextjs.org/docs" 
+            target="_blank" 
+            rel="noopener noreferrer"
+          >
+            Next.js Docs
+          </a>{" "}
+          |{" "}
+          <a 
+            href="https://alchemy.run" 
+            target="_blank" 
+            rel="noopener noreferrer"
+          >
+            Alchemy Docs
+          </a>
+        </p>
+      </footer>
+    </main>
+  );
+}

package/templates/nextjs/tsconfig.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    "lib": ["dom", "dom.iterable", "es6"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "types": ["@cloudflare/workers-types", "./types/env.d.ts"]
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    "alchemy.run.ts"
+  ],
+  "exclude": ["node_modules"]
+}

package/templates/nextjs/types/env.d.ts

@@ -0,0 +1,14 @@
+// Auto-generated Cloudflare binding types.
+// @see https://alchemy.run/concepts/bindings/#type-safe-bindings
+
+import type { website } from "./alchemy.run.ts";
+
+declare global {
+	type CloudflareEnv = typeof website.Env;
+}
+
+declare module "cloudflare:workers" {
+	namespace Cloudflare {
+		export interface Env extends CloudflareEnv {}
+	}
+}

package/templates/nuxt/alchemy.run.ts

@@ -5,9 +5,7 @@ import { Nuxt } from "alchemy/cloudflare";
 
 const app = await alchemy("{projectName}");
 
-export const worker = await Nuxt("website", {
-  name: `${app.name}-${app.stage}-website`,
-});
+export const worker = await Nuxt("website");
 
 console.log({
   url: worker.url,

package/templates/react-router/alchemy.run.ts

@@ -5,9 +5,7 @@ import { ReactRouter } from "alchemy/cloudflare";
 
 const app = await alchemy("{projectName}");
 
-export const worker = await ReactRouter("website", {
-  name: `${app.name}-${app.stage}-website`,
-});
+export const worker = await ReactRouter("website");
 
 console.log({
   url: worker.url,

package/templates/rwsdk/alchemy.run.ts

@@ -5,12 +5,10 @@ import { D1Database, DurableObjectNamespace, Redwood } from "alchemy/cloudflare"
 const app = await alchemy("{projectName}");
     
 const database = await D1Database("database", {
-  name: `${app.name}-${app.stage}-database`,
   migrationsDir: "migrations",
 });
 
 export const worker = await Redwood("website", {
-  name: `${app.name}-${app.stage}-website`,
   bindings: {
     AUTH_SECRET_KEY: alchemy.secret(process.env.AUTH_SECRET_KEY),
     DB: database,

package/templates/sveltekit/alchemy.run.ts

@@ -5,9 +5,7 @@ import { SvelteKit } from "alchemy/cloudflare";
 
 const app = await alchemy("{projectName}");
 
-export const worker = await SvelteKit("website", {
-  name: `${app.name}-${app.stage}-website`,
-});
+export const worker = await SvelteKit("website");
 
 console.log({
   url: worker.url,

package/templates/tanstack-start/alchemy.run.ts

@@ -5,9 +5,7 @@ import { TanStackStart } from "alchemy/cloudflare";
 
 const app = await alchemy("{projectName}");
 
-export const worker = await TanStackStart("website", {
-  name: `${app.name}-${app.stage}-website`,
-});
+export const worker = await TanStackStart("website");
 
 console.log({
   url: worker.url,

package/templates/typescript/alchemy.run.ts

@@ -6,7 +6,6 @@ import { Worker } from "alchemy/cloudflare";
 const app = await alchemy("{projectName}");
 
 export const worker = await Worker("worker", {
-  name: `${app.name}-${app.stage}-website`,
   entrypoint: "src/worker.ts",
 });