alchemy 0.4.1 → 0.5.1

package/lib/secret.js

@@ -5,7 +5,7 @@
  *
  * 1. Globally when initializing the alchemy application:
  * ```ts
- * const app = alchemy("my-app", {
+ * const app = await alchemy("my-app", {
  *   password: process.env.SECRET_PASSPHRASE
  * });
  * ```
@@ -54,7 +54,7 @@ export function isSecret(binding) {
  *
  * @example
  * // Global password for all secrets
- * const app = alchemy("my-app", {
+ * const app = await alchemy("my-app", {
  *   password: process.env.SECRET_PASSPHRASE
  * });
  *

package/lib/web/vitepress/vitepress.js

@@ -76,7 +76,7 @@ export const VitepressProject = Resource("project::VitepressProject", {
         // import { Folder } from "alchemy/fs";
         // import { Document } from "alchemy/docs";
         // import path from "path";
-        // await using _ = alchemy("alchemy.run", {
+        // const app = await alchemy("alchemy.run", {
         //   stage: "prod",
         //   phase: process.argv.includes("--destroy") ? "destroy" : "up",
         //   password: process.env.SECRET_PASSPHRASE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "type": "module",
   "module": "./lib/index.js",
   "scripts": {
@@ -18,6 +18,7 @@
     "./esbuild": "./lib/esbuild/index.js",
     "./fs": "./lib/fs/index.js",
     "./github": "./lib/github/index.js",
+    "./os": "./lib/os/index.js",
     "./shadcn": "./lib/shadcn/index.js",
     "./stripe": "./lib/stripe/index.js",
     "./test/bun": "./lib/test/bun.js",

package/src/ai/data.ts

@@ -63,6 +63,12 @@ export interface DataProps<T extends Type<any, any>> {
    * Model configuration
    */
   model?: ModelConfig;
+
+  /**
+   * Whether to freeze the generated object
+   * @default false
+   */
+  freeze?: boolean;
 }
 
 /**
@@ -171,6 +177,10 @@ export const Data = Resource("ai::Object", async function <
     throw new Error("Either prompt or messages must be provided");
   }
 
+  if (this.phase === "update" && props.freeze) {
+    return this(this.output);
+  }
+
   // Create messages array if only prompt is provided
   const messages = props.messages || [{ role: "user", content: props.prompt! }];
 

package/src/alchemy.ts

@@ -22,7 +22,7 @@ export const alchemy: Alchemy = _alchemy as any;
  *
  * @example
  * // Create an application scope with stage and secret handling
- * const app = alchemy("github:alchemy", {
+ * const app = await alchemy("github:alchemy", {
  *   stage: "prod",
  *   phase: "up",
  *   // Required for encrypting/decrypting secrets
@@ -57,13 +57,13 @@ export interface Alchemy {
    * Used to create and manage resources with proper secret handling.
    *
    * @example
-   * const app = alchemy("my-app", {
+   * const app = await alchemy("my-app", {
    *   stage: "prod",
    *   // Required for encrypting/decrypting secrets
    *   password: process.env.SECRET_PASSPHRASE
    * });
    */
-  (...parameters: Parameters<typeof scope>): ReturnType<typeof scope>;
+  (...parameters: Parameters<typeof scope>): Promise<Scope>;
   /**
    * Template literal tag that supports file interpolation for documentation.
    * Automatically formats the content and appends file contents as code blocks.
@@ -88,11 +88,11 @@ export interface Alchemy {
  * Implementation of the alchemy function that handles both application scoping
  * and template string interpolation.
  */
-function _alchemy(
+async function _alchemy(
   ...args:
     | [template: TemplateStringsArray, ...values: any[]]
     | [appName: string, options?: Omit<AlchemyOptions, "appName">]
-): any {
+): Promise<Scope | string | never> {
   if (typeof args[0] === "string") {
     const [appName, options] = args as [string, AlchemyOptions?];
     const root = scope(undefined, {
@@ -101,9 +101,8 @@ function _alchemy(
       stage: options?.stage,
     });
     if (options?.phase === "destroy") {
-      return destroy(root).finally(() => {
-        process.exit(0);
-      });
+      await destroy(root);
+      return process.exit(0);
     }
     return root;
   } else {
@@ -114,106 +113,104 @@ function _alchemy(
       : 0;
     const indent = " ".repeat(leadingSpaces);
 
-    return (async () => {
-      const { isFileCollection, isFileRef } = await import("./fs");
+    const { isFileCollection, isFileRef } = await import("./fs");
 
-      const appendices: Record<string, string> = {};
+    const appendices: Record<string, string> = {};
 
-      const stringValues = await Promise.all(
-        values.map(async function resolve(value): Promise<string> {
-          if (typeof value === "string") {
-            return indent + value;
-          } else if (value === null) {
-            return "null";
-          } else if (value === undefined) {
-            return "undefined";
-          } else if (
-            typeof value === "number" ||
-            typeof value === "boolean" ||
-            typeof value === "bigint"
-          ) {
-            return value.toString();
-          } else if (value instanceof Promise) {
-            return resolve(await value);
-          } else if (isFileRef(value)) {
-            if (!(value.path in appendices)) {
-              appendices[value.path] = await fs.readFile(value.path, "utf-8");
-            }
+    const stringValues = await Promise.all(
+      values.map(async function resolve(value): Promise<string> {
+        if (typeof value === "string") {
+          return indent + value;
+        } else if (value === null) {
+          return "null";
+        } else if (value === undefined) {
+          return "undefined";
+        } else if (
+          typeof value === "number" ||
+          typeof value === "boolean" ||
+          typeof value === "bigint"
+        ) {
+          return value.toString();
+        } else if (value instanceof Promise) {
+          return resolve(await value);
+        } else if (isFileRef(value)) {
+          if (!(value.path in appendices)) {
+            appendices[value.path] = await fs.readFile(value.path, "utf-8");
+          }
+          return `[${path.basename(value.path)}](${value.path})`;
+        } else if (isFileCollection(value)) {
+          return Object.entries(value.files)
+            .map(([filePath, content]) => {
+              appendices[filePath] = content;
+              return `[${path.basename(filePath)}](${filePath})`;
+            })
+            .join("\n\n");
+        } else if (Array.isArray(value)) {
+          return (
+            await Promise.all(
+              value.map(async (value, i) => `${i}. ${await resolve(value)}`)
+            )
+          ).join("\n");
+        } else if (
+          typeof value === "object" &&
+          typeof value.path === "string"
+        ) {
+          if (typeof value.content === "string") {
+            appendices[value.path] = value.content;
             return `[${path.basename(value.path)}](${value.path})`;
-          } else if (isFileCollection(value)) {
-            return Object.entries(value.files)
-              .map(([filePath, content]) => {
-                appendices[filePath] = content;
-                return `[${path.basename(filePath)}](${filePath})`;
-              })
-              .join("\n\n");
-          } else if (Array.isArray(value)) {
-            return (
-              await Promise.all(
-                value.map(async (value, i) => `${i}. ${await resolve(value)}`)
-              )
-            ).join("\n");
-          } else if (
-            typeof value === "object" &&
-            typeof value.path === "string"
-          ) {
-            if (typeof value.content === "string") {
-              appendices[value.path] = value.content;
-              return `[${path.basename(value.path)}](${value.path})`;
-            } else {
-              appendices[value.path] = await fs.readFile(value.path, "utf-8");
-              return `[${path.basename(value.path)}](${value.path})`;
-            }
-          } else if (typeof value === "object") {
-            return (
-              await Promise.all(
-                Object.entries(value).map(async ([key, value]) => {
-                  return `* ${key}: ${await resolve(value)}`;
-                })
-              )
-            ).join("\n");
           } else {
-            // TODO: support other types
-            console.log(value);
-            throw new Error(`Unsupported value type: ${value}`);
+            appendices[value.path] = await fs.readFile(value.path, "utf-8");
+            return `[${path.basename(value.path)}](${value.path})`;
           }
-        })
-      );
-
-      // Construct the string template by joining template parts with interpolated values
-      const lines = template
-        .map((part) =>
-          part
-            .split("\n")
-            .map((line) =>
-              line.startsWith(indent) ? line.slice(indent.length) : line
+        } else if (typeof value === "object") {
+          return (
+            await Promise.all(
+              Object.entries(value).map(async ([key, value]) => {
+                return `* ${key}: ${await resolve(value)}`;
+              })
             )
-            .join("\n")
-        )
-        .flatMap((part, i) =>
-          i < stringValues.length ? [part, stringValues[i] ?? ""] : [part]
-        )
-        .join("")
-        .split("\n");
+          ).join("\n");
+        } else {
+          // TODO: support other types
+          console.log(value);
+          throw new Error(`Unsupported value type: ${value}`);
+        }
+      })
+    );
 
-      // Collect and sort appendices by file path
-      return [
-        // format the user prompt and trim the first line if it's empty
-        lines.length > 1 && lines[0].replaceAll(" ", "").length === 0
-          ? lines.slice(1).join("\n")
-          : lines.join("\n"),
+    // Construct the string template by joining template parts with interpolated values
+    const lines = template
+      .map((part) =>
+        part
+          .split("\n")
+          .map((line) =>
+            line.startsWith(indent) ? line.slice(indent.length) : line
+          )
+          .join("\n")
+      )
+      .flatMap((part, i) =>
+        i < stringValues.length ? [part, stringValues[i] ?? ""] : [part]
+      )
+      .join("")
+      .split("\n");
 
-        // sort appendices by path and include at the end of the prompt
-        Object.entries(appendices)
-          .sort(([a], [b]) => a.localeCompare(b))
-          .map(([filePath, content]) => {
-            const extension = path.extname(filePath).slice(1);
-            const codeTag = extension ? extension : "";
-            return `// ${filePath}\n\`\`\`${codeTag}\n${content}\n\`\`\``;
-          })
-          .join("\n\n"),
-      ].join("\n");
-    })();
+    // Collect and sort appendices by file path
+    return [
+      // format the user prompt and trim the first line if it's empty
+      lines.length > 1 && lines[0].replaceAll(" ", "").length === 0
+        ? lines.slice(1).join("\n")
+        : lines.join("\n"),
+
+      // sort appendices by path and include at the end of the prompt
+      Object.entries(appendices)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([filePath, content]) => {
+          const extension = path.extname(filePath).slice(1);
+          const codeTag = extension ? extension : "";
+          return `// ${filePath}\n\`\`\`${codeTag}\n${content}\n\`\`\``;
+        })
+        .join("\n\n"),
+    ].join("\n");
   }
 }
 _alchemy.destroy = destroy;

package/src/apply.ts

@@ -70,15 +70,6 @@ export async function apply<Out extends Resource>(
         }
         return state.output as Awaited<Out>;
       }
-
-      const diff = await import("diff");
-      const yaml = await import("yaml");
-      const old = yaml.stringify(oldProps);
-      const news = yaml.stringify(newProps);
-      const patch = diff.createPatch(resource.ID, old, news);
-      // console.log(patch);
-      // if (resource.ID === "what-is-alchemy") {
-      // }
     }
 
     const phase = state.status === "creating" ? "create" : "update";

package/src/cloudflare/assets.ts

@@ -86,6 +86,9 @@ export interface AssetFile {
  */
 export const Assets = Resource(
   "cloudflare::Asset",
+  {
+    alwaysUpdate: true,
+  },
   async function (
     this: Context<Assets>,
     id: string,

package/src/cloudflare/bound.ts

@@ -1,4 +1,5 @@
 import type { Secret } from "../secret";
+import type { Assets } from "./assets";
 import type { Binding } from "./bindings";
 import type { R2Bucket as _R2Bucket } from "./bucket";
 import type { DurableObjectNamespace as _DurableObjectNamespace } from "./durable-object-namespace";
@@ -15,4 +16,6 @@ export type Bound<T extends Binding> = T extends _DurableObjectNamespace
         ? R2Bucket
         : T extends Secret
           ? string
-          : never;
+          : T extends Assets
+            ? Service
+            : Service;

package/src/cloudflare/bucket.ts

@@ -40,11 +40,18 @@ export interface BucketProps extends CloudflareApiOptions {
   allowPublicAccess?: boolean;
 
   /**
-   * Whether to delete the bucket and its contents during resource deletion
+   * Whether to delete the bucket.
    * If set to false, the bucket will remain but the resource will be removed from state
-   * Default: true
+   *
+   * @default true
    */
   delete?: boolean;
+
+  /**
+   * Whether to empty the bucket and delete all objects during resource deletion
+   * @default false
+   */
+  empty?: boolean;
 }
 
 /**
@@ -103,6 +110,14 @@ export interface R2Bucket
  *   jurisdiction: "fedramp"
  * });
  *
+ * @example
+ * // Create a bucket that will be automatically emptied when deleted
+ * // This will delete all objects in the bucket before deleting the bucket itself
+ * const temporaryBucket = await R2Bucket("temp-storage", {
+ *   name: "temp-storage",
+ *   empty: true  // All objects will be deleted when this resource is destroyed
+ * });
+ *
  * @see https://developers.cloudflare.com/r2/buckets/
  */
 export const R2Bucket = Resource(
@@ -112,18 +127,18 @@ export const R2Bucket = Resource(
     id: string,
     props: BucketProps
   ): Promise<R2Bucket> {
-    const [api, r2Client] = await Promise.all([
-      createCloudflareApi(props),
-      createR2Client(props),
-    ]);
-
+    const api = await createCloudflareApi(props);
     const bucketName = props.name || this.id;
 
     if (this.phase === "delete") {
       console.log("Deleting R2 bucket:", bucketName);
       if (props.delete !== false) {
-        // Empty the bucket first by deleting all objects
-        await emptyBucket(r2Client, bucketName, props.jurisdiction);
+        if (props.empty) {
+          console.log("Emptying R2 bucket:", bucketName);
+          const r2Client = await createR2Client(props);
+          // Empty the bucket first by deleting all objects
+          await emptyBucket(r2Client, bucketName, props.jurisdiction);
+        }
 
         // Delete R2 bucket
         console.log("Deleting R2 bucket:", bucketName);

package/src/cloudflare/custom-domain.ts

@@ -64,8 +64,7 @@ export interface CustomDomain
 
 /**
  * Configure custom domain for a Cloudflare Worker using the Cloudflare Custom Domains API
- * This attaches a worker (either a standard Worker or the one backing a StaticSite)
- * to a specific hostname within a zone.
+ * This attaches a worker to a specific hostname within a zone.
  *
  * @example
  * // Bind a domain to a standard Cloudflare Worker
@@ -80,19 +79,6 @@ export interface CustomDomain
  *   workerName: apiWorker.name // Use the name from the Worker resource
  * });
  *
- * @example
- * // Bind a domain to a Cloudflare Static Site
- * const mySite = await StaticSite("landing-page", {
- *   name: "my-landing-page-site", // This becomes the underlying worker name
- *   dir: "./dist/landing-page"
- * });
- *
- * const siteDomain = await CustomDomain("site-domain-binding", {
- *   name: "www.example.com",
- *   zoneId: "YOUR_ZONE_ID", // Replace with actual Zone ID
- *   workerName: mySite.name // Use the name from the StaticSite resource
- * });
- *
  * @see https://developers.cloudflare.com/api/resources/workers/subresources/domains/
  */
 export const CustomDomain = Resource(

package/src/cloudflare/index.ts

@@ -9,7 +9,6 @@ export * from "./durable-object-namespace";
 export * from "./kv-namespace";
 export * from "./permission-groups";
 export * from "./r2-rest-state-store";
-export * from "./static-site";
 export * from "./worker";
 export * from "./wrangler.json";
 export * from "./zone";

package/src/cloudflare/worker.ts

@@ -101,6 +101,11 @@ export interface WorkerProps<B extends Bindings = Bindings> {
    * Migrations to apply to the worker
    */
   migrations?: SingleStepMigration;
+
+  /**
+   * Whether to adopt the Worker if it already exists when creating
+   */
+  adopt?: boolean;
 }
 
 /**
@@ -245,7 +250,9 @@ export const Worker = Resource(
       await deleteWorker(this, api, workerName);
       return this.destroy();
     } else if (this.phase === "create") {
-      await assertWorkerDoesNotExist(this, api, workerName);
+      if (!props.adopt) {
+        await assertWorkerDoesNotExist(this, api, workerName);
+      }
     }
 
     const oldBindings = await this.get<Bindings>("bindings");

package/src/internal/docs/providers.ts

@@ -124,6 +124,7 @@ async function generateProviderDocs({
         reasoningEffort: "high",
       },
     },
+    freeze: true,
     temperature: 0.1,
     schema: type({
       groups: type({
@@ -156,7 +157,7 @@ async function generateProviderDocs({
       A file is considered a "Utility" if it contains utility functions that are not resources or clients.
       A file is considered a "Types" if it contains just type definitions and maybe helpers around working with those types.
 
-      The title should be simply the name of the resource's const in code (with spaces added in between each word), e.g. "Bucket" or "Function", except with spaces, e.g. "Static Site" for "const StaticSite". Maintain all other casing.
+      The title should be simply the name of the resource's const in code (with spaces added in between each word), e.g. "Bucket" or "Function", except with spaces, e.g. "StaticSite" for "const StaticSite". Maintain all other casing.
 
       // "Resource Name"
       const ResourceName = Resource(...)