alchemy 0.64.0 → 0.65.1

package/src/util/dedent.ts

@@ -1,5 +1,3 @@
-import assert from "node:assert";
-
 /**
  * Tagged template literal for removing indentation from a block of text.
  *
@@ -10,34 +8,48 @@ export function dedent(strings: TemplateStringsArray, ...values: unknown[]) {
   const raw = String.raw({ raw: strings }, ...values);
   // Split the string by lines
   let lines = raw.split("\n");
-  assert(lines.length > 0);
 
-  // If the last line is just whitespace, remove it
-  if (lines[lines.length - 1].trim() === "") {
+  // Remove leading blank lines
+  while (lines.length > 0 && lines[0].trim() === "") {
+    lines = lines.slice(1);
+  }
+
+  // Remove trailing blank lines
+  while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
     lines = lines.slice(0, lines.length - 1);
   }
 
-  // Find the minimum-length indent, excluding the first line
-  let minIndent = "";
-  // (Could use `minIndent.length` for this, but then would need to start with
-  // infinitely long string)
+  // If no content lines remain, return empty string
+  if (lines.length === 0) {
+    return "";
+  }
+
+  // Find the minimum-length indent from content lines (non-blank lines)
   let minIndentLength = Number.POSITIVE_INFINITY;
-  for (const line of lines.slice(1)) {
-    const indent = line.match(/^[ \t]*/)?.[0];
-    if (indent != null && indent.length < minIndentLength) {
-      minIndent = indent;
-      minIndentLength = indent.length;
+  for (const line of lines) {
+    if (line.trim() !== "") {
+      const indent = line.match(/^[ \t]*/)?.[0];
+      if (indent != null && indent.length < minIndentLength) {
+        minIndentLength = indent.length;
+      }
     }
   }
 
-  // If the first line is just whitespace, remove it
-  if (lines.length > 0 && lines[0].trim() === "") {
-    lines = lines.slice(1);
+  // If no indentation found, return lines as-is
+  if (minIndentLength === Number.POSITIVE_INFINITY) {
+    return lines.join("\n");
   }
 
-  // Remove indent from all lines, and return them all joined together
-  lines = lines.map((line) =>
-    line.startsWith(minIndent) ? line.substring(minIndent.length) : line,
-  );
+  // Remove indent from all lines, preserving blank lines
+  lines = lines.map((line) => {
+    if (line.trim() === "") {
+      return line; // Preserve blank lines
+    }
+    return line.startsWith(" ".repeat(minIndentLength)) ||
+      line.startsWith("\t".repeat(minIndentLength))
+      ? line.substring(minIndentLength)
+      : line;
+  });
+
   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
@@ -24,6 +25,17 @@ export function memoize<F extends (...args: any[]) => Promise<any>>(
   };
 }
 
-export const defaultKeyFn = (...args: any[]) => {
-  return createHash("sha256").update(JSON.stringify(args)).digest("hex");
-};
+export function defaultKeyFn(...args: any[]): string {
+  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/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 {}
+	}
+}