release blog post first draft

Author: thescientist13

src/pages/blog/release/v0-32-0.md

@@ -0,0 +1,160 @@
+---
+title: Release - v0.32.0
+abstract: TODO
+published: 2025-4-12
+coverImage: /assets/blog/acorn.webp
+layout: blog
+---
+
+# Greenwood v0.32.0
+
+**Published: April 12th, 2025**
+
+<img src="https://raw.githubusercontent.com/ProjectEvergreen/www.greenwoodjs.dev/03867761c4c28cad202097a2ea39670393bb80a9/src/assets/aws.svg" style="display:block; width: 25%; margin: 0 auto;" alt="AWS logo"/>
+
+## What's New
+
+Along with a round of bug fixes and miscellaneous enhancements, this new Greenwood release brings with it two big new features we are excited to share. We now have an official AWS Adapter for deploying dynamic pages and routes to Lambda functions, as well as now making our TypeScript plugin officially built-in; no more plugin needed anymore! There was also a small minimum version bump for NodeJS.
+
+This release was also the by-product of some great feedback, support, and contributions from our community. In particular the built-in TypeScript support was very much a collaborative communication process that really helped to strengthen Greenwood as a project that can be a pragmatic and productive experience to develop with. We very much enjoyed the conversations we had around this topic and the end result we produced. Thank you so much to everyone who got involved with us for this release, it means a lot to use and it's great to see what you're building with Greenwood! 💚
+
+> Please refer to the [release notes](https://github.com/ProjectEvergreen/greenwood/releases/tag/v0.32.0) for the complete changelog and overview of breaking changes.
+
+## AWS Adapter
+
+While static hosting of your Greenwood project was always possible with AWS, serverless support on Lambda for SSR pages and API routes didn't have a formal solution... until now! With this release, there is now an official adapter plugin for generating Lambda compatible function code for your dynamic pages and routes. ☁️
+
+```js
+import { greenwoodPluginAdapterAws } from "@greenwood/plugin-adapter-aws";
+
+export default {
+  plugins: [greenwoodPluginAdapterAws()],
+};
+```
+
+Taking into consideration that there are many methods and options for deploying to AWS, this adapter plugin is primarily focused on generating consistent and predictable build output that can be complimented by some form of [**IaC (Infrastructure as Code)**](https://en.wikipedia.org/wiki/Infrastructure_as_code) or deployment tooling of your choice. The build output will look similar to Greenwood's own [standard build output](/docs/reference/appendix/#build-output) and will be available in the _.aws-output/_ folder at the root of your project.
+
+```shell
+.aws-output/
+  api/
+    event/
+      event.js
+      index.js
+      package.json
+    search/
+      ...
+  routes/
+    admin/
+      ...
+    products/
+      index.js
+      package.json
+      products.route.chunk.jgsTuvlz.js
+      products.route.js
+```
+
+For each of the folders in the _api/_ or _routes/_ directories, it would just be a matter of creating a zip file for each folder / route, or ideally pointing your IaC tooling to those output folders. For example, here is a simplified example from our [**SST**](https://sst.dev/) example repo:
+
+```ts
+// 1) Configure SSR pages and API routes in API Gateway
+const api = new sst.aws.ApiGatewayV2("MyApi");
+
+// products page
+api.route(`GET /routes/products`, {
+  bundle: `.aws-output/routes/products`,
+  handler: "index.handler",
+});
+
+// search API
+api.route(`GET /api/search`, {
+  bundle: `.aws-output/api/search`,
+  handler: "index.handler",
+})
+
+// 2) Setup hosting for static content
+const frontend = new sst.aws.StaticSite("MyStaticSite", {
+  path: "./",
+  build: {
+    output: "public"
+  },
+})
+
+// 3) Configure CloudFront router with SSR pages, API routes, and static content
+const router = new sst.aws.Router("MyRouter", {
+  routes: {
+    "/api/*": api.url,
+    {
+      url: api.url,
+      rewrite: {
+        regex: `^/products/$`,
+        to: `/routes/products`
+      }
+    },
+    "/*": frontend.url
+  },
+  invalidation: true,
+});
+
+// 4) Configure SST app
+export default $config({
+  app(input) {
+    return {
+      name: "my-app",
+      removal: input?.stage === "production" ? "retain" : "remove",
+      protect: ["production"].includes(input?.stage),
+      home: "aws",
+    };
+  },
+  async run() {
+    router
+  },
+});
+```
+
+> Naturally you wouldn't want to hardcode these, so please check out our full [AWS hosting documentation](/guides/hosting/aws/#serverless) for more details, including example repositories using **SST** and **Architect**.
+
+## Built-in TypeScript Support
+
+With this release, Greenwood now provides built-in support for TypeScript, with the ability to fallback to using `tsc` if certain TypeScript features you're using (like Decorators, [enums, namespaces, etc](https://devblogs.microsoft.com/typescript/announcing-typescript-5-8/#the---erasablesyntaxonly-option)) are not supported through just type stripping alone. This was motivated due to [NodeJS version `>= 22.6.0`](https://nodejs.org/en/learn/typescript/run-natively) now making type stripping available by using the `--experimental-strip-types` flag. This also means you can remove Greenwood's [TypeScript plugin](https://greenwoodjs.dev/docs/plugins/typescript/) as it is has been deprecated with this release.
+
+```json
+{
+  "scripts": {
+    "build": "NODE_OPTIONS='--experimental-strip-types' greenwood build"
+  }
+}
+```
+
+This also means that you can author your Greenwood configuration files and plugins with TypeScript!
+
+```ts
+// greenwood.config.ts
+import type { Config } from "@greenwood/cli";
+
+const config: Config = {
+  // ...
+};
+
+export default config;
+```
+
+For actual _type-checking_, you can of course install **typescript** in your project and use Greenwood's minimum recommended _tsconfig.json_ settings so that you can run `tsc` during CI.
+
+```json
+{
+  "compilerOptions": {
+    "module": "preserve",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": false,
+    "noEmit": true,
+    "erasableSyntaxOnly": true
+  }
+}
+```
+
+> Check out our [TypeScript docs](/docs/resources/typescript/) to learn more about getting setup with TypeScript and Greenwood.
+
+---
+
+As always, we're excited to see where the community can take Greenwood and are always available to chat on [GitHub](https://github.com/ProjectEvergreen/greenwood) or [Discord](/discord/). See you for the next release! ✌️