alchemy 0.1.11 → 0.1.12

package/README.md

@@ -0,0 +1,324 @@
+# Alchemy
+
+Alchemy is a JS-native, embeddable library for the materialization of resource graphs. From Infrastructure-as-Code (IaC) to code generation, Alchemy provides the fundamental building blocks for modeling resources that are Created, Updated and Deleted automatically.
+
+Unlike similar tools like Pulumi, Terraform, and CloudFormation, Alchemy is implemented in pure ESM-native TypeScript with zero dependencies. It can run in any JavaScript runtime, including the browser.
+
+[![Demo](./alchemy.gif)](./alchemy.gif)
+
+# Features
+
+- **JS-native** - no second language, toolchains, dependencies, processes, services, etc. to lug around.
+- **ESM-native** - built exclusively on ESM, with a slight preference for modern JS runtimes like Bun.
+- **Embeddable** - runs in any JavaScript/TypeScript environment, including the browser!
+- **Extensible** - implement your own resources with a simple function.
+- **AI-first** - alchemy actively encourages you to use LLMs to create/copy/fork/modify resources to fit your needs. No more waiting around for a provider to be implemented, just do it yourself in a few minutes.
+- **No dependencies** - the `alchemy` core package has 0 required dependencies.
+- **No service** - state files are stored locally in your project and can be easily inspected, modified, checked into your repo, etc.
+- **No strong opinions** - structure your codebase however you want, store state anywhere - we don't care!
+
+# Examples
+
+- LLM-based code generation of all 200+ AWS CloudFormation resources: [examples/generate-aws-cfn/gen.ts](./examples/generate-aws-cfn/gen.ts)
+- Deploy an AWS Lambda Function with a DynamoDB Table and IAM Role: [examples/deploy-aws/app.ts](./examples/deploy-aws/)
+- Generate a TODO application from a Markdown document: [examples/markdown-program/index.md](./examples/markdown-program/)
+
+# Getting Started
+
+An alchemy "app" (if you want to call it that) is just an ordinary TypeScript or JavaScript script. Once you've installed the `alchemy` package, you can start using it however you want.
+
+```bash
+# I recommend bun, but you can use any JavaScript runtime.
+bun add alchemy
+```
+
+Usually, you'll want to create a script where you'll define your resources.
+
+```ts
+import { Role } from "alchemy/aws";
+
+const role = new Role("my-role", {
+  name: "my-role",
+  //..
+});
+```
+
+Then, call `alchemize` at the end to trigger the Create/Update/Delete lifecycle.
+
+```ts
+await alchemize();
+```
+
+Finally, run your script.
+
+```sh
+bun ./my-app.ts
+```
+
+You'll notice some files show up in your repo:
+
+```
+.alchemy/
+  - sam/
+    - my-role.json
+```
+
+Go ahead, click on one and take a look. Here's how my role looks:
+
+```jsonc
+{
+  "provider": "iam::Role",
+  "data": {},
+  "deps": [],
+  "status": "updated",
+  "output": {
+    "roleName": "alchemy-api-lambda-role"
+    // ..
+  },
+  "inputs": [
+    {
+      "roleName": "alchemy-api-lambda-role",
+      "assumeRolePolicy": {
+        "Version": "2012-10-17"
+        // ..
+      }
+    }
+  ]
+}
+```
+
+> [!TIP]
+> Alchemy goes to great effort to be fully transparent. State is just a JSON file, nothing more. You can inspect it, modify it, commit it to your repo, etc.
+
+## `alchemize`
+
+Calling `alchemize` will create new resources, update modified resources and then delete "orphaned" resources at the end.
+
+This is equivalent to `terraform apply`, `pulumi up`, `cdk deploy`, etc. except really fast and in your control.
+
+## Creating a Resource Provider
+
+Adding new resources is the whole point of Alchemy, and is therefore very simple.
+
+A Resource provider is just a function with a globally unique name, e.g. `dynamo::Table`, and an implementation of the Create, Update, Delete lifecycle operations.
+
+E.g. below we show what a simple `dynamo::Table` provider might look like.
+
+> [!NOTE]
+> See [table.ts](./alchemy/src/components/aws/table.ts) for the full implementation.
+
+```ts
+interface TableInputs {
+  name: string;
+  //..
+}
+interface TableOutput {
+  tableArn: string;
+}
+class Table extends Resource(
+  "dynamo::Table",
+  async (ctx: Context<TableOutput>, inputs: TableInputs) => {
+    if (ctx.event === "create") {
+      // create logic
+    } else if (ctx.event === "update") {
+      // update logic
+    } else if (ctx.event === "delete") {
+      // delete logic
+    }
+    // ..
+    return output;
+  }
+) {}
+```
+
+> [!TIP]
+> Use Cursor or an LLM like Claude/OpenAI to generate the implementation of your resource. I think you'll be pleasantly surprised at how well it works, especially if you provide the API reference docs in your context.
+
+That's it! Now you can instantiate tables in your app.
+
+```ts
+const table = new Table("items", {
+  name: "items",
+  //..
+});
+
+table.tableArn; // Output<string>
+```
+
+You may have noticed the odd pattern of extending the result of a function call, `extends Resource(..)`. This is called the "mix-in" pattern and is optional. You are free to just use a `const` instead:
+
+```ts
+const Table = Resource("dynamo::Table", async (ctx, inputs) => {
+  //..
+});
+
+const table = new Table("items", {
+  name: "items",
+  //..
+});
+```
+
+> [!TIP]
+> I recommend using a class so each resource has a type, e.g. `Table`, and a place to add helper/utility methods. Totally optional, though. Knock yourself out.
+
+## Lazy Outputs
+
+A Resource is evaluated lazily (not when you call `new`), so you can't immediately access the value of a property like `tableArn` or `functionArn`. Instead you reference properties using the `Output<T>` interface.
+
+```ts
+const table = new Table("my-table", { .. });
+
+const tableArn = table.tableArn; // Output<string>
+```
+
+Outputs can be chained explicitly and implicitly:
+
+1. _Explicitly_ with `.apply`
+
+```ts
+const tableArn: Output<string> = table.tableArn.apply((arn: string) =>
+  // do something with the arn string value
+  arn.replace("table", "arn:aws:dynamodb:")
+);
+```
+
+2. _Implicitly_ chained
+
+```ts
+const tableArn = table.attributeDefinitions[0].attributeName; // Output<string>
+// equivalent to:
+// table.apply(t => t.attributeDefinitions[0].attributeName);
+```
+
+> [!NOTE]
+> Output is inspired by Pulumi, with a little extra added sugar.
+
+## `apply` and `destroy`
+
+Calling `alchemize` is optional. Any object in your graph (`Resource` or `Output<T>`) can be "applied" or "destroyed" individually and programmatically.
+
+Say, you've got some two resources, a `Role` and a `Function`.
+
+```ts
+const role = new Role("my-role", {
+  name: "my-role",
+  //..
+});
+
+const func = new Function("my-function", {
+  name: "my-function",
+  role: role.roleArn,
+  //..
+});
+```
+
+Each of these Resources is known as a "sub-graph".
+
+In this case we have `Role` (a 1-node graph, `Role`), and `Function` (a 2-node graph, `Role → Function`).
+
+Each sub-graph can be "applied" or "destroyed" individually using the `apply` and `destroy` functions:
+
+```ts
+import { apply, destroy } from "alchemy";
+
+// will create Role and then Function (in that order)
+const { functionArn } = await apply(func);
+
+// you can destroy it right after if you want ☠️
+await destroy(func); // will delete just the Function
+
+// destroy deletes the resource and any downstream dependencies
+// so, if you want to delete Role AND Function, you should call destroy(role)
+await destroy(role); // will delete Role and then Function
+```
+
+## Destroying the app
+
+To destroy the whole app (aka. the whole graph), you can call `alchemize` with the `mode: "destroy"` option. This will delete all resources in the specified or default stage.
+
+```ts
+await alchemize({ mode: "destroy", stage: <optional> });
+```
+
+> [!TIP]
+> Alchemy is designed to have the minimum number of opinions as possible. This "embeddable" design is so that you can implement your own tools around Alchemy, e.g. a CLI or UI, instead of being stuck with a specific tool.
+>
+> ```ts
+> await alchemize({
+>   // decide the mode/stage however you want, e.g. a CLI parser
+>   mode: process.argv[2] === "destroy" ? "destroy" : "up",
+>   stage: process.argv[3],
+> });
+> ```
+
+## "Stage" and State
+
+> [!NOTE]
+> Stage is inspired by [SST](https://sst.dev)'s stage concept.
+
+Alchemy supports a "stage" concept to help isolate different environments from each other. E.g. a `"user"` or `"dev"` or `"prod"` stage.
+
+By default, the stage is assumed to be your user name (a sensible default for local development).
+
+To override the stage, you have three options:
+
+1. Pass the `stage` option to `alchemize`/`apply`/`destroy` (recommended)
+
+```ts
+// alchemize the entire app
+await alchemize({ stage: "production" });
+
+// apply a single resource
+await apply(func, { stage: "production" });
+```
+
+2. Config in `./alchemy.ts` (up to you if you want to have a global config). See the [alchemy.ts section](#global-values-and-the-alchemy-ts-config-file) for more details.
+
+```ts
+export default {
+  defaultStage: "production",
+};
+```
+
+3. Set the `ALCHEMY_STAGE` environment variable (not recommended, but available as an escape hatch)
+
+```sh
+ALCHEMY_STAGE=production bun ./my-app.ts
+```
+
+Each Resource "provider" can access the stage it's being deployed to via the `ctx.stage` property.
+
+```ts
+class Table extends Resource("dynamo::Table", async (ctx, inputs) => {
+  ctx.stage; // "production"
+});
+```
+
+> [!CAUTION]
+> It is up to you to ensure that the physical names of resources don't conflict - alchemy does not (yet) offer any help or opinions here. You must decide on physical names, but you're free to add name generation logic to your resources if you so desire.
+>
+> ```ts
+> class Table extends Resource("dynamo::Table", async (ctx, inputs) => {
+>   const tableName = `${ctx.stage}-${inputs.tableName}`;
+>
+>   // ..
+> });
+> ```
+
+## Global values and the `alchemy.ts` config file.
+
+Alchemy looks for a `${cwd}/alchemy.ts` file and imports it if it finds it. This can be useful for emulating SST's `sst.config.ts` file as a convention for global configuration.
+
+It supports overriding the `defaultStage` (instead of defaulting to your username) and providing a custom `stateStore` (instead of writing to the local file system).
+
+```ts
+import type { Config } from "alchemy";
+
+export default {
+  defaultStage: "dev",
+  stateStore: myCustomStateStore,
+} satisfies Config;
+```
+
+> [!NOTE]
+> See [global.ts](./alchemy/src/global.ts).

package/lib/apply.d.ts

@@ -1,4 +1,4 @@
-import { Output } from "./output";
+import { type Output, type Resolve } from "./output";
 import { type Scope as IScope } from "./scope";
 import type { StateStore } from "./state";
 export interface ApplyOptions {
@@ -12,7 +12,7 @@ export interface ApplyOptions {
  * @param output A sub-graph that produces a resource.
  * @returns The resource properties.
  */
-export declare function apply<T>(output: T | Output<T>, options?: Partial<ApplyOptions>): Promise<T>;
+export declare function apply<T>(output: T, options?: Partial<ApplyOptions>): Promise<Resolve<T>>;
 declare class Evaluated<T> {
     readonly value: T;
     readonly deps: string[];

package/lib/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQlC,OAAO,EAAE,KAAK,KAAK,IAAI,MAAM,EAAY,MAAM,SAAS,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CASZ;AAED,cAAM,SAAS,CAAC,CAAC;aAEG,KAAK,EAAE,CAAC;aACR,IAAI,EAAE,MAAM,EAAE;gBADd,KAAK,EAAE,CAAC,EACR,IAAI,GAAE,MAAM,EAAO;CAEtC;AAID,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EACrB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAiFvB"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAe,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAQlE,OAAO,EAAE,KAAK,KAAK,IAAI,MAAM,EAAY,MAAM,SAAS,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CASrB;AAED,cAAM,SAAS,CAAC,CAAC;aAEG,KAAK,EAAE,CAAC;aACR,IAAI,EAAE,MAAM,EAAE;gBADd,KAAK,EAAE,CAAC,EACR,IAAI,GAAE,MAAM,EAAO;CAEtC;AAID,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EACrB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAiFvB"}

package/lib/apply.js

@@ -1,5 +1,5 @@
 import { defaultStage, defaultStateStore } from "./global";
-import { Output } from "./output";
+import { OutputChain } from "./output";
 import { Input, Provider, ResourceID, isResource, } from "./resource";
 import { getScope } from "./scope";
 /**
@@ -53,7 +53,7 @@ export async function evaluate(output, options) {
         }
         return promise;
     }
-    else if (output instanceof Output) {
+    else if (output instanceof OutputChain) {
         const inside = output;
         const parent = await evaluate(inside.parent, options);
         const ret = inside.fn(parent.value);

package/lib/apply.js.map

@@ -1 +1 @@
-{"version":3,"file":"apply.js","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"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"}

package/lib/aws/index.d.ts

@@ -3,5 +3,6 @@ export * from "./function";
 export * from "./policy";
 export * from "./queue";
 export * from "./role";
+export * from "./ses";
 export * from "./table";
 //# sourceMappingURL=index.d.ts.map

package/lib/aws/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aws/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aws/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC"}

package/lib/aws/index.js

@@ -3,5 +3,6 @@ export * from "./function";
 export * from "./policy";
 export * from "./queue";
 export * from "./role";
+export * from "./ses";
 export * from "./table";
 //# sourceMappingURL=index.js.map

package/lib/aws/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aws/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aws/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC"}

package/lib/aws/ses.d.ts

@@ -0,0 +1,75 @@
+import { type DeliveryOptions, type ReputationOptions, type SendingOptions, type SuppressionOptions, type TrackingOptions } from "@aws-sdk/client-sesv2";
+/**
+ * Properties for configuring AWS SES resources
+ */
+export interface SESProps {
+    /**
+     * Name of the configuration set
+     */
+    configurationSetName?: string;
+    /**
+     * Email identity to verify (email address or domain)
+     */
+    emailIdentity?: string;
+    /**
+     * Whether to enable DKIM signing for the email identity
+     */
+    enableDkim?: boolean;
+    /**
+     * Sending options for the configuration set
+     */
+    sendingOptions?: SendingOptions;
+    /**
+     * Reputation options for the configuration set
+     */
+    reputationOptions?: ReputationOptions;
+    /**
+     * Tracking options for the configuration set
+     */
+    trackingOptions?: TrackingOptions;
+    /**
+     * Suppression options for the configuration set
+     */
+    suppressionOptions?: SuppressionOptions;
+    /**
+     * Delivery options for the configuration set
+     */
+    deliveryOptions?: DeliveryOptions;
+    /**
+     * Tags to apply to the SES resources
+     */
+    tags?: Record<string, string>;
+}
+/**
+ * Output returned after SES resource creation/update
+ */
+export interface SESOutput extends SESProps {
+    /**
+     * Resource ID
+     */
+    id: string;
+    /**
+     * ARN of the configuration set if created
+     */
+    configurationSetArn?: string;
+    /**
+     * Email identity verification status if an identity was created
+     */
+    emailIdentityVerificationStatus?: string;
+    /**
+     * DKIM verification status if DKIM was enabled
+     */
+    dkimVerificationStatus?: string;
+    /**
+     * Email identity ARN if an identity was created
+     */
+    emailIdentityArn?: string;
+}
+declare const SES_base: import("../resource").Provider<"aws::SES", [props: SESProps], SESOutput>;
+/**
+ * AWS SES resource for creating and configuring Simple Email Service
+ */
+export declare class SES extends SES_base {
+}
+export {};
+//# sourceMappingURL=ses.d.ts.map

package/lib/aws/ses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ses.d.ts","sourceRoot":"","sources":["../../src/aws/ses.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EAKpB,KAAK,iBAAiB,EAEtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAI/B;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,+BAA+B,CAAC,EAAE,MAAM,CAAC;IAEzC;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;;AAED;;GAEG;AACH,qBAAa,GAAI,SAAQ,QAkPxB;CAAG"}