alchemy 0.3.0 → 0.4.0

package/src/cloudflare/worker.ts

@@ -16,6 +16,7 @@ import type { DurableObjectNamespace } from "./durable-object-namespace";
 import { isKVNamespace } from "./kv-namespace";
 import type { WorkerScriptMetadata } from "./worker-metadata";
 import type { SingleStepMigration } from "./worker-migration";
+
 /**
  * Properties for creating or updating a Worker
  */
@@ -209,7 +210,7 @@ export const Worker = Resource(
   async function <const B extends Bindings>(
     this: Context<Worker<NoInfer<B>>>,
     id: string,
-    props: WorkerProps<B>,
+    props: WorkerProps<B>
   ): Promise<Worker<B>> {
     // Create Cloudflare API client with automatic account discovery
     const api = await createCloudflareApi();
@@ -234,7 +235,7 @@ export const Worker = Resource(
     const scriptMetadata = await prepareWorkerMetadata(
       this,
       oldBindings,
-      props,
+      props
     );
 
     // Get the script content - either from props.script, or by bundling
@@ -254,7 +255,7 @@ export const Worker = Resource(
       this,
       api,
       workerName,
-      props.url ?? false,
+      props.url ?? false
     );
 
     // Get current timestamp
@@ -277,17 +278,17 @@ export const Worker = Resource(
       // phantom property
       Env: undefined!,
     });
-  },
+  }
 );
 
 async function deleteWorker<B extends Bindings>(
   ctx: Context<Worker<B>>,
   api: CloudflareApi,
-  workerName: string,
+  workerName: string
 ) {
   // Delete worker
   const deleteResponse = await api.delete(
-    `/accounts/${api.accountId}/workers/scripts/${workerName}`,
+    `/accounts/${api.accountId}/workers/scripts/${workerName}`
   );
 
   // Check for success (2xx status code)
@@ -297,7 +298,7 @@ async function deleteWorker<B extends Bindings>(
       .catch(() => ({ errors: [{ message: deleteResponse.statusText }] }));
     console.error(
       "Error deleting worker:",
-      errorData.errors?.[0]?.message || deleteResponse.statusText,
+      errorData.errors?.[0]?.message || deleteResponse.statusText
     );
   }
 
@@ -308,7 +309,7 @@ async function deleteWorker<B extends Bindings>(
 
     if (!routesResponse.ok) {
       throw new Error(
-        `Could not fetch routes for cleanup: ${routesResponse.status} ${routesResponse.statusText}`,
+        `Could not fetch routes for cleanup: ${routesResponse.status} ${routesResponse.statusText}`
       );
     }
     const routesData: any = await routesResponse.json();
@@ -318,12 +319,12 @@ async function deleteWorker<B extends Bindings>(
       if (ctx.output.routes.includes(route.pattern)) {
         // Delete the route
         const routeDeleteResponse = await api.delete(
-          `/zones/${api.zoneId}/workers/routes/${route.id}`,
+          `/zones/${api.zoneId}/workers/routes/${route.id}`
         );
 
         if (!routeDeleteResponse.ok) {
           console.warn(
-            `Failed to delete route ${route.pattern}: ${routeDeleteResponse.status} ${routeDeleteResponse.statusText}`,
+            `Failed to delete route ${route.pattern}: ${routeDeleteResponse.status} ${routeDeleteResponse.statusText}`
           );
         }
       }
@@ -338,7 +339,7 @@ async function deleteWorker<B extends Bindings>(
         JSON.stringify({ enabled: false }),
         {
           headers: { "Content-Type": "application/json" },
-        },
+        }
       );
     } catch (error) {
       console.warn("Failed to disable worker URL during deletion:", error);
@@ -353,7 +354,7 @@ async function putWorker(
   api: CloudflareApi,
   workerName: string,
   scriptContent: string,
-  scriptMetadata: WorkerMetadata,
+  scriptMetadata: WorkerMetadata
 ) {
   return withExponentialBackoff(
     async () => {
@@ -371,7 +372,7 @@ async function putWorker(
             ? "application/javascript+module"
             : "application/javascript",
         }),
-        scriptName,
+        scriptName
       );
 
       // Add metadata as JSON
@@ -379,7 +380,7 @@ async function putWorker(
         "metadata",
         new Blob([JSON.stringify(scriptMetadata)], {
           type: "application/json",
-        }),
+        })
       );
 
       await new Promise((resolve) => setTimeout(resolve, 1000));
@@ -392,7 +393,7 @@ async function putWorker(
           headers: {
             "Content-Type": "multipart/form-data",
           },
-        },
+        }
       );
 
       // Check if the upload was successful
@@ -416,7 +417,7 @@ async function putWorker(
     },
     (err) => err instanceof NotFoundError,
     10,
-    100,
+    100
   );
 }
 
@@ -441,7 +442,7 @@ interface WorkerMetadata {
 async function prepareWorkerMetadata<B extends Bindings>(
   ctx: Context<Worker<B>>,
   oldBindings: Bindings | undefined,
-  props: WorkerProps,
+  props: WorkerProps
 ): Promise<WorkerMetadata> {
   // Prepare metadata with bindings
   const meta: WorkerMetadata = {
@@ -498,7 +499,7 @@ async function prepareWorkerMetadata<B extends Bindings>(
       });
 
       const oldBinding: DurableObjectNamespace | undefined = Object.values(
-        oldBindings ?? {},
+        oldBindings ?? {}
       )
         ?.filter(isDurableObjectNamespace)
         ?.find((b) => b.id === stableId);
@@ -561,10 +562,10 @@ async function prepareWorkerMetadata<B extends Bindings>(
 async function assertWorkerDoesNotExist<B extends Bindings>(
   ctx: Context<Worker<B>>,
   api: CloudflareApi,
-  workerName: string,
+  workerName: string
 ) {
   const response = await api.get(
-    `/accounts/${api.accountId}/workers/scripts/${workerName}`,
+    `/accounts/${api.accountId}/workers/scripts/${workerName}`
   );
   if (response.status === 404) {
     return true;
@@ -574,24 +575,24 @@ async function assertWorkerDoesNotExist<B extends Bindings>(
 
     if (!metadata) {
       throw new Error(
-        `Worker exists but failed to fetch metadata: ${response.status} ${response.statusText}`,
+        `Worker exists but failed to fetch metadata: ${response.status} ${response.statusText}`
       );
     }
 
     if (
       metadata.default_environment?.script.tags.includes(
-        `alchemy:id:${slugify(ctx.fqn)}`,
+        `alchemy:id:${slugify(ctx.fqn)}`
       )
     ) {
       return true;
     }
 
     throw new Error(
-      `Worker with name '${workerName}' already exists. Please use a unique name.`,
+      `Worker with name '${workerName}' already exists. Please use a unique name.`
     );
   } else {
     throw new Error(
-      `Error checking if worker exists: ${response.status} ${response.statusText} ${await response.text()}`,
+      `Error checking if worker exists: ${response.status} ${response.statusText} ${await response.text()}`
     );
   }
 }
@@ -634,7 +635,7 @@ async function bundleWorkerScript<B extends Bindings>(props: WorkerProps) {
 async function setupRoutes(
   api: CloudflareApi,
   workerName: string,
-  routes: string[],
+  routes: string[]
 ) {
   // Set up routes if provided
   if (routes && routes.length > 0 && api.zoneId) {
@@ -643,7 +644,7 @@ async function setupRoutes(
 
     if (!routesResponse.ok) {
       throw new Error(
-        `Could not fetch routes: ${routesResponse.status} ${routesResponse.statusText}`,
+        `Could not fetch routes: ${routesResponse.status} ${routesResponse.statusText}`
       );
     }
     const routesData: any = await routesResponse.json();
@@ -652,7 +653,7 @@ async function setupRoutes(
     // For each desired route
     for (const pattern of routes) {
       const existingRoute = existingRoutes.find(
-        (r: any) => r.pattern === pattern,
+        (r: any) => r.pattern === pattern
       );
 
       if (existingRoute) {
@@ -663,12 +664,12 @@ async function setupRoutes(
             {
               pattern,
               script: workerName,
-            },
+            }
           );
 
           if (!updateRouteResponse.ok) {
             console.warn(
-              `Failed to update route ${pattern}: ${updateRouteResponse.status} ${updateRouteResponse.statusText}`,
+              `Failed to update route ${pattern}: ${updateRouteResponse.status} ${updateRouteResponse.statusText}`
             );
           }
         }
@@ -679,12 +680,12 @@ async function setupRoutes(
           {
             pattern,
             script: workerName,
-          },
+          }
         );
 
         if (!createRouteResponse.ok) {
           throw new Error(
-            `Failed to create route ${pattern}: ${createRouteResponse.status} ${createRouteResponse.statusText}`,
+            `Failed to create route ${pattern}: ${createRouteResponse.status} ${createRouteResponse.statusText}`
           );
         }
       }
@@ -696,7 +697,7 @@ async function configureURL<B extends Bindings>(
   ctx: Context<Worker<B>>,
   api: CloudflareApi,
   workerName: string,
-  url: boolean,
+  url: boolean
 ) {
   let workerUrl;
   if (url) {
@@ -706,17 +707,17 @@ async function configureURL<B extends Bindings>(
       { enabled: true, previews_enabled: true },
       {
         headers: { "Content-Type": "application/json" },
-      },
+      }
     );
 
     // Get the account's workers.dev subdomain
     const subdomainResponse = await api.get(
-      `/accounts/${api.accountId}/workers/subdomain`,
+      `/accounts/${api.accountId}/workers/subdomain`
     );
 
     if (!subdomainResponse.ok) {
       throw new Error(
-        `Could not fetch workers.dev subdomain: ${subdomainResponse.status} ${subdomainResponse.statusText}`,
+        `Could not fetch workers.dev subdomain: ${subdomainResponse.status} ${subdomainResponse.statusText}`
       );
     }
     const subdomainData: {
@@ -743,11 +744,11 @@ async function configureURL<B extends Bindings>(
       JSON.stringify({ enabled: false }),
       {
         headers: { "Content-Type": "application/json" },
-      },
+      }
     );
     if (!response.ok) {
       throw new Error(
-        `Failed to disable worker URL: ${response.status} ${response.statusText}`,
+        `Failed to disable worker URL: ${response.status} ${response.statusText}`
       );
     }
   }
@@ -756,17 +757,17 @@ async function configureURL<B extends Bindings>(
 
 async function getWorkerScriptMetadata(
   api: CloudflareApi,
-  workerName: string,
+  workerName: string
 ): Promise<WorkerScriptMetadata | undefined> {
   const response = await api.get(
-    `/accounts/${api.accountId}/workers/services/${workerName}`,
+    `/accounts/${api.accountId}/workers/services/${workerName}`
   );
   if (response.status === 404) {
     return undefined;
   }
   if (!response.ok) {
     throw new Error(
-      `Error getting worker script metadata: ${response.status} ${response.statusText}`,
+      `Error getting worker script metadata: ${response.status} ${response.statusText}`
     );
   }
   return ((await response.json()) as any).result as WorkerScriptMetadata;
@@ -775,7 +776,7 @@ async function getWorkerScriptMetadata(
 async function getWorkerBindings(
   api: CloudflareApi,
   workerName: string,
-  environment = "production",
+  environment = "production"
 ) {
   const response = await api.get(
     `/accounts/${api.accountId}/workers/services/${workerName}/environments/${environment}/bindings`,
@@ -784,7 +785,7 @@ async function getWorkerBindings(
         Authorization: `Bearer ${process.env.CLOUDFLARE_API_TOKEN}`,
         "Content-Type": "application/json",
       },
-    },
+    }
   );
 
   if (response.status === 404) {
@@ -793,7 +794,7 @@ async function getWorkerBindings(
 
   if (!response.ok) {
     throw new Error(
-      `Failed to fetch bindings: ${response.status} ${response.statusText}`,
+      `Failed to fetch bindings: ${response.status} ${response.statusText}`
     );
   }
 

package/src/dns/import-dns.ts

@@ -134,7 +134,7 @@ export const ImportDnsRecords = Resource(
   async function (
     this: Context<ImportDnsRecords>,
     id: string,
-    props: ImportDnsRecordsProps,
+    props: ImportDnsRecordsProps
   ): Promise<ImportDnsRecords> {
     // For delete phase, just return destroyed state since this is a read-only resource
     if (this.phase === "delete") {
@@ -152,7 +152,7 @@ export const ImportDnsRecords = Resource(
             headers: {
               accept: "application/dns-json",
             },
-          },
+          }
         );
 
         if (!res.ok) {
@@ -197,7 +197,7 @@ export const ImportDnsRecords = Resource(
       } catch (error) {
         console.warn(
           `Failed to fetch ${type} records for ${props.domain}:`,
-          error,
+          error
         );
       }
     }
@@ -209,5 +209,5 @@ export const ImportDnsRecords = Resource(
       records: allRecords,
       importedAt: Date.now(),
     });
-  },
+  }
 );

package/src/{util/encrypt.ts → encrypt.ts}

@@ -7,17 +7,14 @@ import sodium from "libsodium-wrappers";
  * @param key - The encryption key
  * @returns The base64-encoded encrypted value with nonce
  */
-export async function encryptWithKey(
-  value: string,
-  key: string,
-): Promise<string> {
+export async function encrypt(value: string, key: string): Promise<string> {
   // Initialize libsodium
   await sodium.ready;
 
   // Derive a key from the passphrase
   const cryptoKey = sodium.crypto_generichash(
     sodium.crypto_secretbox_KEYBYTES,
-    sodium.from_string(key),
+    sodium.from_string(key)
   );
 
   // Generate a random nonce
@@ -27,7 +24,7 @@ export async function encryptWithKey(
   const encryptedBin = sodium.crypto_secretbox_easy(
     sodium.from_string(value),
     nonce,
-    cryptoKey,
+    cryptoKey
   );
 
   // Combine nonce and ciphertext, then encode to base64
@@ -47,7 +44,7 @@ export async function encryptWithKey(
  */
 export async function decryptWithKey(
   encryptedValue: string,
-  key: string,
+  key: string
 ): Promise<string> {
   // Initialize libsodium
   await sodium.ready;
@@ -55,13 +52,13 @@ export async function decryptWithKey(
   // Derive a key from the passphrase
   const cryptoKey = sodium.crypto_generichash(
     sodium.crypto_secretbox_KEYBYTES,
-    sodium.from_string(key),
+    sodium.from_string(key)
   );
 
   // Decode the base64 combined value
   const combined = sodium.from_base64(
     encryptedValue,
-    sodium.base64_variants.ORIGINAL,
+    sodium.base64_variants.ORIGINAL
   );
 
   // Extract nonce and ciphertext
@@ -72,7 +69,7 @@ export async function decryptWithKey(
   const decryptedBin = sodium.crypto_secretbox_open_easy(
     ciphertext,
     nonce,
-    cryptoKey,
+    cryptoKey
   );
 
   return sodium.to_string(decryptedBin);

package/src/fs/copy-file.ts

@@ -0,0 +1,115 @@
+import fs from "node:fs";
+import type { Context } from "../context";
+import { Resource } from "../resource";
+import { ignore } from "../util/ignore";
+
+/**
+ * Properties for creating a CopyFile resource
+ */
+export interface CopyFileProps {
+  /**
+   * Source path of the file to copy
+   */
+  src: string;
+
+  /**
+   * Destination path where the file should be copied to
+   */
+  dest: string;
+
+  /**
+   * Whether to overwrite the destination file if it already exists
+   * @default true
+   */
+  overwrite?: boolean;
+}
+
+/**
+ * Output returned after CopyFile creation/update
+ */
+export interface CopyFile extends Resource<"fs::CopyFile">, CopyFileProps {
+  /**
+   * Time at which the object was created
+   */
+  createdAt: number;
+
+  /**
+   * Whether the file was successfully copied
+   */
+  copied: boolean;
+}
+
+/**
+ * CopyFile Resource
+ *
+ * Copies a file from a source location to a destination location.
+ *
+ * @example
+ * // Copy a file to a new location
+ * const copiedFile = await CopyFile("config-copy", {
+ *   src: "config.json",
+ *   dest: "backup/config.json"
+ * });
+ *
+ * @example
+ * // Copy a file without overwriting if destination exists
+ * const safeCopy = await CopyFile("safe-copy", {
+ *   src: "data.json",
+ *   dest: "backup/data.json",
+ *   overwrite: false
+ * });
+ */
+export const CopyFile = Resource(
+  "fs::CopyFile",
+  async function (
+    this: Context<CopyFile>,
+    id: string,
+    props: CopyFileProps
+  ): Promise<CopyFile> {
+    const { src, dest, overwrite = true } = props;
+
+    if (this.phase === "delete") {
+      // When deleting, remove the destination file
+      await ignore("ENOENT", async () => fs.promises.unlink(dest));
+      return this.destroy();
+    } else {
+      try {
+        // Check if source file exists
+        await fs.promises.access(src, fs.constants.F_OK);
+
+        // If this is an update and the destination has changed, delete the old file
+        if (
+          this.phase === "update" &&
+          this.output?.dest &&
+          this.output.dest !== dest
+        ) {
+          await ignore("ENOENT", async () =>
+            fs.promises.unlink(this.output.dest)
+          );
+        }
+
+        // Check if destination file exists
+        const destinationExists = await fs.promises
+          .access(dest, fs.constants.F_OK)
+          .then(() => true)
+          .catch(() => false);
+
+        // Copy file if destination doesn't exist or overwrite is true
+        if (!destinationExists || overwrite) {
+          await fs.promises.copyFile(src, dest);
+        }
+
+        return this({
+          src,
+          dest,
+          overwrite,
+          copied: true,
+          createdAt: Date.now(),
+        });
+      } catch (error) {
+        console.error(`Error copying file from ${src} to ${dest}:`, error);
+        throw error;
+      }
+    }
+  }
+);

package/src/fs/file-system-state-store.ts

@@ -1,9 +1,9 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import type { Scope } from "../scope";
+import { deserialize, serialize } from "../serde";
 import type { State, StateStore } from "../state";
 import { ignore } from "../util/ignore";
-import { deserialize, serialize } from "../util/serde";
 
 const stateRootDir = path.join(process.cwd(), ".alchemy");
 
@@ -48,7 +48,7 @@ export class FileSystemStateStore implements StateStore {
       const content = await fs.readFile(await this.getPath(key), "utf8");
       const state = (await deserialize(
         this.scope,
-        JSON.parse(content),
+        JSON.parse(content)
       )) as State;
       if (state.output === undefined) {
         state.output = {} as any;
@@ -66,7 +66,7 @@ export class FileSystemStateStore implements StateStore {
   async set(key: string, value: State): Promise<void> {
     return fs.writeFile(
       await this.getPath(key),
-      JSON.stringify(await serialize(this.scope, value), null, 2),
+      JSON.stringify(await serialize(this.scope, value), null, 2)
     );
   }
 
@@ -88,9 +88,9 @@ export class FileSystemStateStore implements StateStore {
               return [] as const;
             }
             return [[id, s]] as const;
-          }),
+          })
         )
-      ).flat(),
+      ).flat()
     );
   }